Payment Response


Web-to-Web Response

Method : POST
Content Type: application/x-www-form-urlencoded
URL : As specified in the returnurl parameter of payment request.

NOTE
  • Gkash unified payment system would redirect the user back to the URL specified in the returnurl parameter of the payment request.
  • Merchant should not rely on the status return from web-to-web response, should rely the status on callbackurl

Response Parameters

Parameter Type Required Description Example

status

String Yes Payment status 88 - Transferred
66 - Failed
11 - Pending

CID

String Yes Merchant ID M102-U-999

POID

String Yes Gkash's Unique Referece No.(Issue by GKash) M102-PO-999

cartid

String Yes Merchant's Unique Referece ID(Order ID from Merchant) GkashPO-12345

currency

String Yes Currency notation (currently only support MYR)
ISO 4217 currency code, e.g. MYR
MYR

amount

String Yes Payment amount 100.00

signature

String Yes

Refer to SHA512 Signature

abcdefghijsdf123131234124

Server-to-server Response (Payment Status Callback)

Method : POST
URL : As specified in the callbackurl parameter of payment request.

NOTE
  • Notify Response
  • Merchant system shall output string "OK" , upon successful receiving payment status notification from Gkash unified payment system.
  • Upon processing the payment request, Gkash unified payment system would notify merchants with the following parameters.

Response Parameters

Parameter Type Required Description Example

status

String Yes Payment status 88 - Transferred
66 - Failed
11 - Pending

CID

String Yes Merchant ID M102-U-999

POID

String Yes Gkash's Unique Referece No.(Issue by GKash) M102-PO-999

cartid

String Yes Merchant's Unique Referece ID(Order ID from Merchant) GkashPO-12345

currency

String Yes Currency notation (currently only support MYR)
ISO 4217 currency code, e.g. MYR
MYR

amount

String Yes Payment amount 100.00

PaymentType

String Yes Payment method Card Payment - “Visa Debit 0029”
Ewallet - “GrabPay ECOMM”

signature

String Yes

Refer to SHA512 Signature

abcdefghijsdf123131234124
Recurring Payment

epkey

String Conditional Recurring payment token epkey12345678900987654321

SubscriptionRemID

String Conditional Subscription ID M102-SC-1

SubscriptionCount

String Conditional Subscription Count 2
An error has occurred. This application may no longer respond until reloaded. Reload 🗙