Transactions
A transaction is one settled card purchase or refund. It shows the gross amount, the fees Straumur deducted and the net amount, along with the settlement and batch it was paid in.
Transactions appear here once they are settled, normally the morning after the purchase. Authorizations that have not been settled yet are not included; see Authorizations for those.
List transactions
GET /api/Transactions
Query parameters
All parameters are optional. Date parameters take a date (2026-10-21) and include the whole From and To days. Amount parameters include From and exclude To.
| Parameter | Type | Description |
|---|---|---|
| AgreementNumber | String | Only transactions on this agreement. |
| SettlementNumber | Integer | Only transactions in the settlement with this settlementNumber. Combine with AgreementNumber in the Partner API. |
| BatchNumber | String | Only transactions in batches with this batch number. |
| TransactionId | Integer | The transaction's id. |
| PurchaseDateFrom | Date | Purchase date from, in the terminal's local time. |
| PurchaseDateTo | Date | Purchase date to, in the terminal's local time. |
| RegistrationDateFrom | Date | Date Straumur processed the transaction, from. |
| RegistrationDateTo | Date | Date Straumur processed the transaction, to. |
| PaidDateFrom | Date | Date the transaction was paid out, from. |
| PaidDateTo | Date | Date the transaction was paid out, to. |
| Currency | String | Transaction currency, for example ISK. |
| GrossAmountFrom | Number | Gross amount from. |
| GrossAmountTo | Number | Gross amount to. |
| NetAmountFrom | Number | Net amount from. |
| NetAmountTo | Number | Net amount to. |
| TransactionType | String | Purchase or Refund (or 2 and 1). |
| CardType | String | Debit or Credit (or 1 and 2). |
| Scheme | String | Card scheme code, for example VI or MC. See Card schemes. |
The list can be large. Always filter by a date range or a settlement. In the Merchant API, transactions are sorted by registration date, newest first.
Example request
curl -u "$USERNAME:$API_KEY" \
"https://partner-api.staging.straumur.is/api/Transactions?AgreementNumber=1000123&PurchaseDateFrom=2026-10-20&PurchaseDateTo=2026-10-20"
Example response
{
"transactions": [
{
"id": "88412093",
"transactionID": "PSP8812345678901234",
"transactionLifeCycleID": "MCC1234561020",
"arn": "74987506293000123456789",
"agreementID": "1000123",
"merchantID": "2001045",
"merchantName": "Kaffihúsið ehf.",
"merchantRegistrationNumber": "5501692829",
"partnerID": "12",
"terminalID": "S1F2L001",
"physicalTerminalID": "V400m-324567890",
"dbaName": "Kaffihúsið Laugavegi",
"purchaseDate": "2026-10-20T14:32:10",
"registrationDate": "2026-10-21T00:00:00Z",
"paidDate": "2026-10-21T09:14:02Z",
"transactionType": "Purchase",
"cardNumber": "541333******0011",
"cardType": "Credit",
"scheme": "MC",
"authorizationNumber": "A1B2C3",
"currency": "ISK",
"grossAmount": 4590.00,
"fees": -64.26,
"netAmount": 4525.74,
"interchange": -9.18,
"schemeFee": -2.30,
"schemeFeeBase": -2.30,
"schemeFeeFixed": 0.00,
"schemeFeePercent": 0.05,
"schemeFeeCurrency": "ISK",
"originalAmount": 4590.00,
"originalCurrency": "ISK",
"cardHolderAmount": 4590.00,
"cardHolderCurrency": "ISK",
"referenceData": "ORDER-100234",
"batchNumber": "1020",
"settlementID": 551203,
"settlementNumber": "2001045-412",
"settlementType": 0,
"merchantBucketName": "Debit and credit, domestic",
"reasonCode": "00",
"transactionCode": "",
"systemSettlementType": "",
"cashbackAmount": 0,
"batchID": "",
"merchantBucketID": ""
}
],
"responseDateTime": "2026-10-22T08:30:11Z",
"responseIdentifier": "3b9d7e21-5c4a-4f0e-b8d6-0a1e2c3f4b5d"
}
Get a transaction by ID
GET /api/Transactions/id/{id}
id is the transaction's id. Returns one transaction in transaction.
Get a transaction by its transaction ID
Merchant API:
GET /api/Transactions/extarnalTransactionId/{externalTransactionId}
Partner API:
GET /api/Transactions/externalTransactionId/{externalTransactionId}
externalTransactionId is the transaction's transactionID, the ID the card processor gave the transaction. For payments processed through Adyen, including Checkout API payments, this is the payment's pspReference. For a refund, it is the refund's own PSP reference. Returns one transaction in transaction.
In the Merchant API, the path segment is spelled extarnalTransactionId. Use it exactly as shown.
When nothing is found
If no transaction you can access matches, or the id is not a number, neither lookup returns 404:
- Merchant API: HTTP
500. A500can also indicate an unexpected server error, so the status alone does not prove that the transaction is missing. - Partner API: HTTP
400with a body such as{"Message": "Transaction not found!"}.
Keep failed lookups unresolved and retry or investigate before excluding the transaction from reconciliation.
Transaction fields
Identifiers
| Field | Type | Description |
|---|---|---|
| id | String | Straumur's ID for the transaction. Use with /api/Transactions/id/{id} and the TransactionId filter. |
| transactionID | String | The card processor's transaction ID. For payments processed through Adyen, the pspReference. |
| transactionLifeCycleID | String | The scheme's ID linking the authorization, the purchase and any refund or chargeback. |
| arn | String | Acquirer reference number. Cardholders' banks use it to trace a transaction. |
| authorizationNumber | String | The authorization code from the card issuer, printed on the receipt. |
| referenceData | String | The merchant reference for online payments, such as your order number. Use it to match transactions to your sales. |
Where and when
| Field | Type | Description |
|---|---|---|
| agreementID | String | The agreement number. |
| merchantID | String | The merchant number. |
| merchantName | String | The merchant's legal name. |
| merchantRegistrationNumber | String | The merchant's registration number (kennitala). |
| partnerID | String | ID of the partner the agreement is linked to, or empty. |
| terminalID | String | The terminal ID (TID). See Terminals. |
| physicalTerminalID | String | The ID of the physical terminal, or empty. |
| dbaName | String | The store name shown to the cardholder. |
| merchantBucketName | String | The name of the pricing plan applied to the transaction, or empty. |
| purchaseDate | String | Date and time of the purchase, in the terminal's local time, with no time zone. |
| registrationDate | String | The date Straumur processed the transaction. |
| paidDate | String | When the transaction was paid out, or null if it has not been paid yet. |
Card
| Field | Type | Description |
|---|---|---|
| transactionType | String | Purchase or Refund. |
| cardNumber | String | The masked card number. Never the full card number. |
| cardType | String | Debit or Credit. |
| scheme | String | The card scheme code. See Card schemes. |
Amounts
All amounts are in the transaction currency unless the field says otherwise. Fees are negative.
| Field | Type | Description |
|---|---|---|
| currency | String | The transaction and settlement currency. |
| grossAmount | Number | The amount of the purchase or refund. |
| fees | Number | All fees Straumur deducted for this transaction. |
| netAmount | Number | grossAmount plus fees: what you receive for this transaction. |
| interchange | Number | The interchange part of fees. Merchant API only; always 0 in the Partner API. |
| schemeFee | Number | The card scheme fee, in schemeFeeCurrency. Merchant API only. |
| schemeFeeBase | Number | The card scheme fee converted to the settlement currency. Merchant API only. |
| schemeFeeFixed | Number | The fixed part of the scheme fee rate. Merchant API only. |
| schemeFeePercent | Number | The percentage part of the scheme fee rate. Merchant API only. |
| schemeFeeCurrency | String | The currency of the scheme fee. Merchant API only. |
| originalAmount | Number | The amount before currency conversion. |
| originalCurrency | String | The currency before conversion. |
| cardHolderAmount | Number | The amount charged in the cardholder's currency. |
| cardHolderCurrency | String | The cardholder's currency. |
Settlement
| Field | Type | Description |
|---|---|---|
| settlementID | Integer | The settlement's ID. Use with /api/Settlements/id/{id}. |
| settlementNumber | String | The settlement's reference (for example 2001045-412), not its number. |
| settlementType | Integer | See Settlement type. |
| batchNumber | String | The batch number. Batch numbers repeat over time. |
Not used
These fields are kept for compatibility and always have the same value: batchID (""), merchantBucketID (""), transactionCode (""), systemSettlementType (""), reasonCode ("00"), cashbackAmount (0). In the Partner API, interchange and all schemeFee fields are always 0 or empty.