payment

iPay88 backend callback

Receives payment status updates from iPay88 (Backend URL)

post/payment/callback/ipay88

Request body

MerchantCodestring required

Merchant Code

PaymentIdstring required

Payment ID

RefNostring required

Reference Number (exactly 20 characters)

Amountstring required

Payment amount

Currencystring required

Currency

Remarkstring

Remark

TransIdstring required

Transaction ID from iPay88

AuthCodestring required

Authorization Code

Statusstring required

Payment Status (1=success, 0=failed)

ErrDescstring

Error description if failed

Signaturestring required

Response signature

TokenIdstring

Token ID for subsequent charges

CardDetailsstring

Card details JSON

MDRstring

MDR (Merchant Discount Rate) details

CCNumberstring

Credit Card Number (masked)

CCNostring

Credit Card Number (masked) - alternative field

CCNamestring

Credit Card Name

S_banknamestring

Bank name

S_countrystring

Country code

TranDatestring

Transaction Date

Optionalobject

Optional JSON object with card details or MDR

Xfield1string

Custom field 1

Example request

{
  "MerchantCode": "M01234",
  "PaymentId": "2",
  "RefNo": "16twtopup34567890123",
  "Amount": "50.00",
  "Currency": "MYR",
  "TransId": "IP88TXN123",
  "AuthCode": "AUTH123",
  "Status": "1",
  "Signature": "abc123..."
}

Response

Callback processed successfully

responsestring required

Callback acknowledgment

Example response

{
  "response": "RECEIVEOK"
}

Changes

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