Skip to main content

Authorizations

An authorization is the card issuer's approval or decline of a payment, sent from the terminal at the time of the purchase. Authorizations are available as soon as Straumur receives them, so you can see today's sales before they are settled.

An authorization has no fees and is not paid out. Once it is settled, the purchase shows up as a transaction with its fees and settlement. Use authorizations for a same-day view of sales, and transactions to reconcile payouts.

List authorizations​

GET /api/Authorizations

Query parameters​

All parameters are optional. Date parameters take a date (2026-10-21) and include the whole From and To days, in the terminal's local time.

ParameterTypeDescription
TransactionDateFromDateAuthorization date from, in the terminal's local time.
TransactionDateToDateAuthorization date to, in the terminal's local time.
AgreementNumberStringOnly authorizations on this agreement.
ContractIdIntegerOnly authorizations on the agreement with this contractId.
MerchantIdIntegerOnly authorizations for the merchant with this merchantId. Partner API only.
StoreIdIntegerOnly authorizations at the store with this storeId.
TidStringOnly authorizations on this terminal ID (TID), the terminalID from Terminals.
TerminalIdIntegerOnly authorizations on the terminal with this terminalId.
CurrencyStringAuthorization currency, for example ISK.
SchemeStringCard scheme code, for example VI or MC. See Card schemes.
TransactionTypeStringPurchase or Refund (or 2 and 1).
AuthorizationStatusStringApproved or Declined (or 1 and 2).

Authorizations are sorted by authorization time, newest first. The list is not paged, so always filter by a date range.

Example request​

curl -u "$USERNAME:$API_KEY" \
"https://partner-api.staging.straumur.is/api/Authorizations?AgreementNumber=1000123&TransactionDateFrom=2026-10-21&TransactionDateTo=2026-10-21"

Example response​

{
"authorizations": [
{
"id": "51830277",
"transactionTime": "2026-10-21T14:32:10",
"processingTime": "2026-10-21T14:32:11Z",
"amount": 4590.00,
"currency": "ISK",
"scheme": "MC",
"cardSummary": "0011",
"authorizationCode": "A1B2C3",
"transactionType": "Purchase",
"isReversal": false,
"authorizationStatus": "Approved",
"responseCode": "00",
"tid": "S1F2L001",
"terminalId": 40211,
"physicalTerminalId": "V400m-324567890",
"externalTransactionId": "PSP8812345678901234",
"merchantId": 2001045,
"contractId": 30877,
"agreementNumber": "1000123",
"storeId": 18342
}
],
"responseDateTime": "2026-10-21T14:40:02Z",
"responseIdentifier": "9f1c3e5a-7b2d-4c6e-8a0f-1d3b5c7e9a2f"
}

Get an authorization by ID​

GET /api/Authorizations/id/{id}

id is the authorization's id. Returns one authorization in authorization.

Get an authorization by its transaction ID​

GET /api/Authorizations/externalTransactionId/{externalTransactionId}

externalTransactionId is the authorization's externalTransactionId. If several authorizations share it, the newest is returned. Returns one authorization in authorization.

When nothing is found​

If no authorization you can access matches, or the id is not a number:

  • Merchant API: HTTP 500. A 500 can also indicate an unexpected server error, so the status alone does not prove that the authorization is missing.
  • Partner API: HTTP 400 with a body such as {"Message": "Authorization not found"}.

Authorization fields​

FieldTypeDescription
idStringStraumur's ID for the authorization. Use with /api/Authorizations/id/{id}.
transactionTimeStringDate and time of the authorization, in the terminal's local time, with no time zone.
processingTimeStringWhen Straumur received the authorization, in UTC.
amountNumberThe authorized amount.
currencyStringThe authorization currency.
schemeStringThe card scheme code, or null. See Card schemes.
cardSummaryStringThe last four digits of the card number. The full card number is never returned.
authorizationCodeStringThe authorization code from the card issuer, printed on the receipt, or null.
transactionTypeStringPurchase or Refund.
isReversalBooleantrue if this authorization reverses an earlier one.
authorizationStatusStringApproved or Declined. See Authorization status.
responseCodeStringThe response code from the card issuer.
tidStringThe terminal ID (TID), the same as terminalID in Terminals.
terminalIdIntegerStraumur's internal ID for the terminal. Use with the TerminalId filter.
physicalTerminalIdStringThe ID of the physical terminal, or null.
externalTransactionIdStringThe card processor's ID for the authorization, or null.
merchantIdIntegerStraumur's internal ID for the merchant. In the Partner API, use with the MerchantId filter.
contractIdIntegerStraumur's internal ID for the agreement. Use with the ContractId filter.
agreementNumberStringThe agreement number.
storeIdIntegerStraumur's internal ID for the store. Use with the StoreId filter.