Skip to main content

Terminals

A terminal is a physical payment terminal or an online store. Every transaction carries the terminalID it was made on, so use this endpoint to map transactions to your locations or web shops.

List terminals​

GET /api/Terminals

Query parameters​

All parameters are optional.

ParameterTypeDescription
TerminalIdStringThe terminal ID (TID), as shown on transactions in terminalID.
AgreementNumberStringOnly terminals on this agreement.

The Partner API returns only terminals that are valid today. The Merchant API also returns terminals whose validity has ended.

Example request​

curl -u "$USERNAME:$API_KEY" \
"https://partner-api.staging.straumur.is/api/Terminals?AgreementNumber=1000123"

Example response​

{
"terminals": [
{
"merchantName": "Kaffihúsið ehf.",
"merchantID": "2001045",
"terminalID": "S1F2L001",
"dbaName": "Kaffihúsið Laugavegi",
"city": "Reykjavík",
"country": "ISL",
"mcc": "5814",
"status": 4,
"partnerID": "12"
}
],
"responseDateTime": "2026-10-22T08:30:11Z",
"responseIdentifier": "6d2f0c1a-9b8e-4f7d-8a3c-2e1b0f9d7c65"
}

Get a terminal​

GET /api/Terminals/id/{id}

Returns one terminal in terminal, or null if no terminal matches. id is Straumur's internal terminal ID, which the list does not return. To look up a terminal by its TID, use the list with TerminalId.

Terminal fields​

FieldTypeDescription
terminalIDStringThe terminal ID (TID).
dbaNameStringThe store name shown to cardholders.
cityStringThe store's city.
countryStringThe store's country, ISO 3166 alpha-3.
mccStringMerchant category code of the store.
statusIntegerWhether the terminal can take payments. See Terminal status.
merchantNameStringThe merchant's legal name.
merchantIDStringThe merchant number.
partnerIDStringID of the partner the agreement is linked to, if any.
ecomTerminalIdentifierStringPartner API only. Not used yet; always null.