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.
| Parameter | Type | Description |
|---|---|---|
| TransactionDateFrom | Date | Authorization date from, in the terminal's local time. |
| TransactionDateTo | Date | Authorization date to, in the terminal's local time. |
| AgreementNumber | String | Only authorizations on this agreement. |
| ContractId | Integer | Only authorizations on the agreement with this contractId. |
| MerchantId | Integer | Only authorizations for the merchant with this merchantId. Partner API only. |
| StoreId | Integer | Only authorizations at the store with this storeId. |
| Tid | String | Only authorizations on this terminal ID (TID), the terminalID from Terminals. |
| TerminalId | Integer | Only authorizations on the terminal with this terminalId. |
| Currency | String | Authorization currency, for example ISK. |
| Scheme | String | Card scheme code, for example VI or MC. See Card schemes. |
| TransactionType | String | Purchase or Refund (or 2 and 1). |
| AuthorizationStatus | String | Approved 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. A500can also indicate an unexpected server error, so the status alone does not prove that the authorization is missing. - Partner API: HTTP
400with a body such as{"Message": "Authorization not found"}.
Authorization fields
| Field | Type | Description |
|---|---|---|
| id | String | Straumur's ID for the authorization. Use with /api/Authorizations/id/{id}. |
| transactionTime | String | Date and time of the authorization, in the terminal's local time, with no time zone. |
| processingTime | String | When Straumur received the authorization, in UTC. |
| amount | Number | The authorized amount. |
| currency | String | The authorization currency. |
| scheme | String | The card scheme code, or null. See Card schemes. |
| cardSummary | String | The last four digits of the card number. The full card number is never returned. |
| authorizationCode | String | The authorization code from the card issuer, printed on the receipt, or null. |
| transactionType | String | Purchase or Refund. |
| isReversal | Boolean | true if this authorization reverses an earlier one. |
| authorizationStatus | String | Approved or Declined. See Authorization status. |
| responseCode | String | The response code from the card issuer. |
| tid | String | The terminal ID (TID), the same as terminalID in Terminals. |
| terminalId | Integer | Straumur's internal ID for the terminal. Use with the TerminalId filter. |
| physicalTerminalId | String | The ID of the physical terminal, or null. |
| externalTransactionId | String | The card processor's ID for the authorization, or null. |
| merchantId | Integer | Straumur's internal ID for the merchant. In the Partner API, use with the MerchantId filter. |
| contractId | Integer | Straumur's internal ID for the agreement. Use with the ContractId filter. |
| agreementNumber | String | The agreement number. |
| storeId | Integer | Straumur's internal ID for the store. Use with the StoreId filter. |