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 |