Get Transaction Details

Retrieve transaction authorization data, partner bank details, installment duration, card details, and net merchant financial settlement breakdowns for a specific transaction ID.

Endpoint

GET /installment/transaction/{transaction_id}/details

Path Parameters

Parameter	Type	Required	Description
`transaction_id`	String (UUID)	Yes	Unique identifier of the transaction (e.g. `60b43176-5991-4475-8ef6-c73c2417c805`).

Request Headers

Authorization: YOUR_SECRET_KEY
X-Amwal-Key: sandbox-amwal-xxx

Header	Type	Required	Description
`Authorization`	String	Yes	Your Amwal Secret Key (e.g. `d9ccf8bc-ed63-44ad-a54c-9d8fee63df6b`).
`X-Amwal-Key`	String	No	Merchant publishable API Key or sandbox identifier.

Response (`200 OK`)

{
  "transaction_id": "60b43176-5991-4475-8ef6-c73c2417c805",
  "status": "success",
  "amount": 299.99,
  "currency": "SAR",
  "bank_name": "Al Rajhi Bank",
  "installment_tenure_months": 6,
  "monthly_installment_amount": 50.00,
  "interest_rate": 0.0,
  "card": {
    "brand": "Visa",
    "last4": "4242",
    "country": "SA"
  },
  "fees": {
    "gateway_fee": 4.50,
    "vat": 0.68,
    "net_merchant_amount": 294.81
  },
  "refunded_amount": 0.00,
  "refund_tracker": null,
  "installment_tracker": {
    "id": "275460",
    "status": "A",
    "message": "Operation Successful"
  },
  "settlement_due_date": "2026-08-27",
  "created_at": "2026-05-14T11:22:10Z"
}

Response Parameters

Transaction Core Details

Field	Type	Description
`transaction_id`	String (UUID)	Unique Amwal transaction identifier.
`status`	String	Authorization lifecycle state: `pending`, `success`, `fail`, `partially refunded`, or `refunded`.
`amount`	Number	Total authorized transaction gross amount in SAR.
`currency`	String	ISO 4217 Currency code (`SAR`).
`bank_name`	String	Partner bank processing the installment (e.g. `Al Rajhi Bank`, `SNB`, `Alinma Bank`, `Riyad Bank`).
`installment_tenure_months`	Integer	Authorized tenure duration in months (`3`, `6`, `12`, `24`).
`monthly_installment_amount`	Number	Monthly installment charged to cardholder at 0% APR.
`interest_rate`	Number	Buyer interest rate (`0.0` for 0% promotional installments).
`refunded_amount`	Number	Total amount refunded so far across all accepted refund requests.
`refund_tracker`	Array of Objects / Null	List of refund records and their gateway settlement status (`P` = Pending, `R` = Settled).
`installment_tracker`	Object / Null	Bank installment verification tracking object with approval code (`status: "A"`).
`settlement_due_date`	String (ISO 8601 Date)	Expected SARIE bank settlement date into the merchant's Saudi bank account (T+2 business days).
`created_at`	String (ISO 8601)	Timestamp of transaction authorization in UTC.

Card Information (`card`)

Field	Type	Description
`brand`	String	Card payment network (e.g. `Visa`, `Mastercard`, `Mada`).
`last4`	String	Last 4 digits of the payment card number.
`country`	String	2-letter ISO country code of the card issuer (e.g. `SA`).

Fee & Settlement Breakdown (`fees`)

Field	Type	Description
`gateway_fee`	Number	Amwal processing transaction fee in SAR.
`vat`	Number	15% VAT applied to the gateway fee in SAR.
`net_merchant_amount`	Number	Net payout amount scheduled for merchant settlement (`amount - gateway_fee - vat`).

Error Responses

Status Code	Error Code	Description
`401 Unauthorized`	`authentication_failed`	Missing or invalid Secret Key in the `Authorization` header.
`404 Not Found`	`transaction_not_found`	The `transaction_id` UUID does not exist or does not belong to your merchant account.

On this page