Skip to main content
GET
/
Gateway
/
v
{version}
/
Transaction
/
by-ref
/
{txnRef}
curl --request GET \
  --url https://waypay-merchant-api.icydesert-41d42f7e.uaenorth.azurecontainerapps.io/Gateway/v1/Transaction/by-ref/TXN20251212123456 \
  --header 'SWICH-API-Key: pk_test_xxxxxxxx'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "amount": 1000,
  "currency": "PKR",
  "fee": 25,
  "netAmount": 975,
  "txType": 0,
  "txnType": "Payment",
  "description": "Product Purchase",
  "transactionNotes": "Payment completed successfully",
  "txnprovider": "JazzCash",
  "txnRef": "TXN20251212123456",
  "status": 3,
  "statusText": "Success",
  "createdAtUtc": "2025-12-12T10:30:00Z"
}

​
Overview

Retrieve detailed information about a specific transaction using its transaction reference number.

​
Path Parameters

​
txnRef
string
required
Transaction reference number
​
version
string
required
API version (e.g., “1”)

​
Response

​
id
uuid
Unique transaction identifier
​
amount
number
Transaction amount
​
currency
string
Currency code (e.g., “PKR”, “USD”)
​
fee
number
Transaction processing fee
​
netAmount
number
Net amount after fees
​
txType
integer
Transaction type:
  • 0 - Payment
  • 1 - Refund
  • 2 - Payout
  • 3 - Settlement
  • 4 - Fee
  • 5 - Adjustment
  • 6 - Chargeback
  • 7 - Reversal
  • 8 - Transfer
​
txnType
string
Transaction type description
​
description
string
Transaction description
​
transactionNotes
string
Additional transaction notes
​
txnprovider
string
Payment provider used
​
txnRef
string
Transaction reference number
​
status
integer
Transaction status:
  • 1 - Pending
  • 2 - Processing
  • 3 - Success
  • 4 - Failed
  • 5 - Cancelled
  • 6 - Expired
  • 7 - Refunded
  • 8 - PartiallyRefunded
  • 9 - Disputed
  • 10 - OnHold
  • 11 - RequiresAction
  • 12 - Declined
​
statusText
string
Human-readable status description
​
createdAtUtc
datetime
Transaction creation timestamp (UTC)
curl --request GET \
  --url https://waypay-merchant-api.icydesert-41d42f7e.uaenorth.azurecontainerapps.io/Gateway/v1/Transaction/by-ref/TXN20251212123456 \
  --header 'SWICH-API-Key: pk_test_xxxxxxxx'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "amount": 1000,
  "currency": "PKR",
  "fee": 25,
  "netAmount": 975,
  "txType": 0,
  "txnType": "Payment",
  "description": "Product Purchase",
  "transactionNotes": "Payment completed successfully",
  "txnprovider": "JazzCash",
  "txnRef": "TXN20251212123456",
  "status": 3,
  "statusText": "Success",
  "createdAtUtc": "2025-12-12T10:30:00Z"
}