payment

Get payment by reference number

Retrieve payment details using reference number

get/payment/ref/{refNo}

Path parameters

refNostring required

Response

Payment retrieved successfully

paymentIdnumber required

Payment ID

refNostring required

Reference number (exactly 20 characters)

status'pending' | 'processing' | 'success' | 'failed' | 'cancelled' required

Payment status

amountnumber required

Amount

currencystring required

Currency

transactionTypestring required

Transaction type

ipay88TransIdstring

iPay88 Transaction ID

ipay88AuthCodestring

iPay88 Authorization Code

ipay88Statusstring

iPay88 Status Code

errorDescriptionstring

Error description if failed

tokenIdstring

Token ID for future payments

memberIdstring

Member ID

walletIdstring

Wallet ID

remarkstring

Remark

createdAtstring date-time required

Created timestamp

updatedAtstring date-time required

Updated timestamp

completedAtstring date-time

Completed timestamp

redirectUrlstring

Redirect URL for initial payment (if no token)

formDataobject

Form data for payment page submission (if no token)

epkeystring

Gkash epkey for recurring payments

gkashStatusstring

Gkash status

gkashTransIdstring

Gkash transaction ID (POID)

gkashPaymentTypestring

Gkash payment type

Example response

{
  "paymentId": 123,
  "refNo": "16twtopup34567890123",
  "status": "success",
  "amount": 50,
  "currency": "MYR",
  "transactionType": "RELOAD",
  "ipay88TransId": "IP88TXN123",
  "ipay88AuthCode": "AUTH123",
  "ipay88Status": "1",
  "cardDetails": {
    "last4": "1234",
    "cardType": "VISA",
    "cardHolderName": "JOHN DOE",
    "expiryMonth": "12",
    "expiryYear": "2025",
    "issuingBank": "MAYBANK",
    "issuingCountry": "MY"
  },
  "memberId": "TWE-123456",
  "walletId": "TWW-123456789012-1",
  "gkashStatus": "88 - Transferred",
  "gkashTransId": "M161-P0-999999",
  "gkashPaymentType": "Master Credit 0008"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.