Host-to-host Request and Response


Server-to-server Request

Method : POST
Content Type: application/x-www-form-urlencoded
Staging URL : https://api-staging.pay.asia/api/Payment/Submit

NOTE

Merchant sends a server-to-server HTTP request to perfrom Recurring/ Preauth-complete Payment.

Request Parameters

Parameter Type Required Description Example

version

String Yes Version number.
Constant string: ‘1.5.1’.
1.5.1

CID

String Yes Merchant ID M102-U-999

v_cartid

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

v_currency

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

v_amount

String Yes Payment amount 100.00

signature

String Yes Refer to SHA512 Signature 1.5.0
Recurring Payment

recurringtype

String Conditional Recurring payment type “MONTHLY”
“ANNUAL”

epkey

String Conditional Recurring payment token EPKEY12345678EPKEY90091
Pre-Auth Payment

v_preauth

String Conditional Preauth payment token M102-PO-999

Server-to-server Response

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

v_cartid

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

v_currency

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

v_amount

String Yes Payment amount 100.00

PaymentType

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

signature

String Yes

Refer to SHA512 Signature

abcdefghijsdf123131234124
Recurring Payment

epkey

String Conditional Recurring payment token epkey12345678900987654321

Example Response

{
"status" : "88 - Transferred"
"CID" : "M102-U-999"
"POID" : "M102-PO-999"
"v_cartid" : "GkashPO-12345"
"v_currency" : "MYR"
"v_amount" : "100.00"
"PaymentType" : "GrabPay POS"
"signature" : "abcdefghijsdf123131234124"
"epkey" : "epkey12345678900987654321"
}
An error has occurred. This application may no longer respond until reloaded. Reload 🗙