5.5 GRABPAY

GrabPay is an e-wallet created by Grab, Southeast Asia's largest ride sharing company that has expanded into delivery services, mobile payments, and financial services. Grab offers these services to over 100 million users in a single app. Shoppers make payments within the app using a GrabPay wallet that they link to their credit or debit card.

ScenarioCategoryPayment methodPayment productIntegration typeAuthenticationRedirect TypeCode TypePre-authPartial RefundCancellation supported
OFFLINEEwalletGRABPAYCPQR_CODE_WALLETAPI, POS--Payment code-YES-
OFFLINEEwalletGRABPAYCPQR_CODE_BNPLAPI, POS--Payment code-YES-
OFFLINEEwalletGRABPAYMPQR_CODE_WALLETAPI, POS--Order code-YES-
ONLINEEwalletGRABPAYMPQR_CODE_BNPLAPI, POS--Order code-YES-

Payment ProductDescription
CPQR_CODE_WALLETGrabpay payment product. QR code in customer-Presented Mode supports consumer pay by wallet balance.
CPQR_CODE_BNPLGrabpay payment product. QR code in customer-Presented Mode supports consumer use buy now pay later method.
MPQR_CODE_WALLETGrabpay payment product. QR code in merchant-Presented Mode supports consumer pay by wallet balance.
MPQR_CODE_BNPLGrabpay payment product. QR code in merchant-Presented Mode supports consumer use buy now pay later method.

Experience and integration process

CapabilitiesAPIsDescription
Initiate a paymentPAY
Refund a paymentREFUND
Inquiry transaction resultDETAIL
Notify transaction resultNOTIFICATION

Initiate a payment

Field Description Required

paymentMethod

Must be "GRABPAY"

M

product

For User-Presented Mode pay by wallet balance, it must be "CPQR_CODE_WALLET";
For User-Presented Mode pay by BNPL , it must be "CPQR_CODE_BNPL";
For Merchant-Presented Mode pay by wallet balance, it must be "MPQR_CODE_WALLET";
For Merchant-Presented Mode pay by BNPL , it must be "MPQR_CODE_BNPL";

M

expireAt

The format is "yyyy-MM-dd hh:mm:ss", and it must be less than 72 hours after the payment request is sent.

M

payCodeValue

It's required when the product is "CPQR_CODE_BNPL" and "CPQR_CODE_WALLET"

C

Handle the payment result

To complete the payment:

  • MPQR_CODE_WALLET, MPQR_CODE_BNPL
  1. To complete the payment, present the QR code image(payAction, "type": "QRCODE", "qrCodeData") to the shopper for scanning.
  2. After the shopper completes the payment, wait for the NOTIFICATION or submit a DETAIL request for the payment result.
  • CPQR_CODE_WALLET, CPQR_CODE_BNPL
  1. Use the data.status from the PAY response to present the payment result to your shopper. You can also wait for the NOTIFICATION or submit a DETAIL request for the payment result.