Skip to main content

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.

ParameterTypeDescription
AgreementNumberStringOnly transactions on this agreement.
SettlementNumberIntegerOnly transactions in the settlement with this settlementNumber. Combine with AgreementNumber in the Partner API.
BatchNumberStringOnly transactions in batches with this batch number.
TransactionIdIntegerThe transaction's id.
PurchaseDateFromDatePurchase date from, in the terminal's local time.
PurchaseDateToDatePurchase date to, in the terminal's local time.
RegistrationDateFromDateDate Straumur processed the transaction, from.
RegistrationDateToDateDate Straumur processed the transaction, to.
PaidDateFromDateDate the transaction was paid out, from.
PaidDateToDateDate the transaction was paid out, to.
CurrencyStringTransaction currency, for example ISK.
GrossAmountFromNumberGross amount from.
GrossAmountToNumberGross amount to.
NetAmountFromNumberNet amount from.
NetAmountToNumberNet amount to.
TransactionTypeStringPurchase or Refund (or 2 and 1).
CardTypeStringDebit or Credit (or 1 and 2).
SchemeStringCard 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.

Spelling in the Merchant API path

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. A 500 can also indicate an unexpected server error, so the status alone does not prove that the transaction is missing.
  • Partner API: HTTP 400 with 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​

FieldTypeDescription
idStringStraumur's ID for the transaction. Use with /api/Transactions/id/{id} and the TransactionId filter.
transactionIDStringThe card processor's transaction ID. For payments processed through Adyen, the pspReference.
transactionLifeCycleIDStringThe scheme's ID linking the authorization, the purchase and any refund or chargeback.
arnStringAcquirer reference number. Cardholders' banks use it to trace a transaction.
authorizationNumberStringThe authorization code from the card issuer, printed on the receipt.
referenceDataStringThe merchant reference for online payments, such as your order number. Use it to match transactions to your sales.

Where and when​

FieldTypeDescription
agreementIDStringThe agreement number.
merchantIDStringThe merchant number.
merchantNameStringThe merchant's legal name.
merchantRegistrationNumberStringThe merchant's registration number (kennitala).
partnerIDStringID of the partner the agreement is linked to, or empty.
terminalIDStringThe terminal ID (TID). See Terminals.
physicalTerminalIDStringThe ID of the physical terminal, or empty.
dbaNameStringThe store name shown to the cardholder.
merchantBucketNameStringThe name of the pricing plan applied to the transaction, or empty.
purchaseDateStringDate and time of the purchase, in the terminal's local time, with no time zone.
registrationDateStringThe date Straumur processed the transaction.
paidDateStringWhen the transaction was paid out, or null if it has not been paid yet.

Card​

FieldTypeDescription
transactionTypeStringPurchase or Refund.
cardNumberStringThe masked card number. Never the full card number.
cardTypeStringDebit or Credit.
schemeStringThe card scheme code. See Card schemes.

Amounts​

All amounts are in the transaction currency unless the field says otherwise. Fees are negative.

FieldTypeDescription
currencyStringThe transaction and settlement currency.
grossAmountNumberThe amount of the purchase or refund.
feesNumberAll fees Straumur deducted for this transaction.
netAmountNumbergrossAmount plus fees: what you receive for this transaction.
interchangeNumberThe interchange part of fees. Merchant API only; always 0 in the Partner API.
schemeFeeNumberThe card scheme fee, in schemeFeeCurrency. Merchant API only.
schemeFeeBaseNumberThe card scheme fee converted to the settlement currency. Merchant API only.
schemeFeeFixedNumberThe fixed part of the scheme fee rate. Merchant API only.
schemeFeePercentNumberThe percentage part of the scheme fee rate. Merchant API only.
schemeFeeCurrencyStringThe currency of the scheme fee. Merchant API only.
originalAmountNumberThe amount before currency conversion.
originalCurrencyStringThe currency before conversion.
cardHolderAmountNumberThe amount charged in the cardholder's currency.
cardHolderCurrencyStringThe cardholder's currency.

Settlement​

FieldTypeDescription
settlementIDIntegerThe settlement's ID. Use with /api/Settlements/id/{id}.
settlementNumberStringThe settlement's reference (for example 2001045-412), not its number.
settlementTypeIntegerSee Settlement type.
batchNumberStringThe 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.