Get Transaction Details

📌 Retrieving Transaction Details

Once a payment is finalized, the transaction ID is included in the URL parameters of the callback. It's important to capture and store this ID to access the complete transaction details later. Depending on the payment status received, you should then manage the corresponding order transaction within your system accordingly.

📘
API Reference
For detailed request/response schemas and interactive testing, visit: Get Transaction Details API

🔗 API Endpoint

GET /payment_links/transaction/{transaction_id}/details

Path Parameters

Parameter	Type	Required	Description
`transaction_id`	string (UUID)	✅	Unique identifier for the transaction

Example Response

{
  "address_details": {
    "city": "Riyadh",
    "name": "Ahmed Al-Rashid",
    "state": "Riyadh Province",
    "country": "SA",
    "street1": "123 King Fahd Road",
    "street2": "Suite 100",
    "postcode": "12345"
  },
  "refunded_amount": "0.00",
  "amount": "299.99000",
  "amwal_fee": "9.00",
  "amwal_tax_vat": "1.35",
  "app_notified": false,
  "approval_type": null,
  "brand_percentage": "2.30",
  "brand_static_fee": "1.00",
  "card_last_4_digits": "",
  "card_holder": "",
  "card_payment_brand": "",
  "client_email": "[email protected]",
  "client_first_name": "Ahmed",
  "client_last_name": "Al-Rashid",
  "client_phone_number": "+966501234567",
  "client_registered": false,
  "created_at": "2025-10-15T20:53:48.060394+03:00",
  "discount": "0.00000",
  "fees": "0.00000",
  "has_new_registration": true,
  "hyperpay_checkout_id": null,
  "hypersplit_id": null,
  "id": "4703ddc9-f2b4-46d8-9139-443b757e369f",
  "is_approved_by_client": null,
  "is_refundable": true,
  "merchant_business_name": "Amwal Shop",
  "merchant_country_code": "SA",
  "merchant_english_business_name": "Amwal Shop",
  "merchant_key": "sandbox-amwal-b87482f2-55da-486f-9ec5-e2ceb47a0333",
  "merchant_payout": "289.64",
  "order_details": null,
  "paymentBrand": "MASTER",
  "payment_method": "Card",
  "payment_option": "Pay In Full",
  "ref_id": null,
  "shipping": "0.00000",
  "shipping_details": null,
  "status": "success",
  "store_domain": "https://shop.amwal.tech/",
  "store_logo": "https://backend.sa.amwal.tech/media/store_logo/481a2629-ca3.jpg",
  "taxes": "0.00000",
  "total_amount": "299.99",
  "convenience_fee": "0.00",
  "payment_amount": "299.99",
  "failure_reason": null,
  "type": "SANDBOX",
  "gateway": 11,
  "gateway_type": 4,
  "payment_link_id": "dbfa9bd3-558d-4c0d-894d-556e63706864",
  "payment_link_callback_url": "https://shop.amwal.tech/webhook/payment-complete",
  "payment_link_description": "Annual premium subscription with advanced features and priority support",
  "billing_address_required": false,
  "supports_stc_pay": false,
  "refund_tracker": null,
  "merchant_domain": "https://shop.amwal.tech/",
  "card_type": "",
  "card_bank_issuer": "",
  "installment_fee": "0.00",
  "installment_fee_vat": "0.00",
  "installment_duration": null,
  "branch_name": "-",
  "payment_link_lang": "en",
  "payment_link_only_show_bank_installments": false,
  "payment_link_only_show_pay_in_full": false,
  "payment_link_show_shipping": false,
  "payment_link_passkey_enabled": false,
  "address_required": false,
  "funding_method": "credit",
  "issuer": "Test Bank",
  "number": "545454xxxxxx5454",
  "bank_name": "",
  "trx_lang": "en"
}