Documentation

GrabPay Malaysia

GrabPay is an e-wallet, which is part of the Grab super app. Consumers maintain a wallet balance with which they pay. In order to pay with GrabPay, consumers are redirected to GrabPay, where they have to authenticate the transaction using a one-time password. PPRO supports GrabPay in two markets currently, Singapore and Malaysia. The following guide covers an integration to GrabPay in Malaysia.

Suggest Edits

Payment Method Properties

Available country codesMY
Processing (Presentation) currenciesMYR
Settlement currenciesUSD
Consumer currenciesMYR
Channel member taggrabpaymy
Scheme name in the settlement fileGrabPay MY
Minimum transaction amountMYR 1.01
Maximum transaction amountMYR 1500
Session timeout3 hours
RefundFull, partial and multiple partial refunds are all available.
Refund Validity90 days

Note: Merchant must have sufficient unsettled wallet balance for refund to succeed. If refund fails, try again after more purchases are made.
Chargeback
Integration TypeAsynchronous
SandboxPPRO-hosted Simulator

Transaction Flow

  1. Consumer conducts the checkout process on merchant's webpage; selects GrabPay
  2. Merchant sends a GrabPay transaction request to PSP
  3. PSP creates a payment request to PPRO for GrabPay
  4. PPRO returns redirect URL to GrabPay payment page
  5. PSP forwards the redirect URL to the merchant
  6. Merchant redirects the consumer to GrabPay payment page
  7. Consumer logs in with their account credentials, enters Grab pin as authorization to complete the payment
  8. Consumer is redirected back to merchant’s merchant redirect URL
  9. Grab sends success notification to PPRO
  10. PPRO sends its own notification to PSP
  11. PSP sends get transaction status to PPRO upon validating and receiving notification
  12. PPRO returns the status to the PSP
  13. PSP send succeeded notification to merchant; merchant informs shopper of success

GrabPay MY Integration

Specific input parameters for the TRANSACTION call

Field NameM/O/CTypeDescription
specin.emailMasciiThe RFC-compliant email address of the account holder
specin.phoneMasciiValid international phone number of the account holder

For standard input parameters, see Input parameters for the TRANSACTION call.

Specific output parameters for the TRANSACTION call

This payment method has no specific output parameters.

For standard output parameters, see Output parameters for the TRANSACTION call.

TRANSACTION call input

tag=grabpaymy
&txtype=TRANSACTION
&countrycode=MY
&currency=MYR
&amount=250
&merchanttxid=84564142227
&login=johndoe
&password=wXBrpVporFVjGO4R
&contractid=JOHNDOETESTCONTRACT
&channel=testchannel
&merchantredirecturl=https%3A%2F%2Fmerchant.com%2Fwork%2Fppro2%2Flanding.php
&notificationurl=https%3A%2F%2Fmerchant.com%2Fwork%2Fppro2%2Fnotification.php
&accountholdername=Tester%20Doe
&specin.email=example%40example.com
&specin.phone=0123834753
&returnmode=urlencodeext

TRANSACTION call output

REQUESTSTATUS=SUCCEEDED
&STATUS=SUCCEEDED
&TXID=553231415
&ERRMSG=
&CHANNEL=testchannel
&TAG=touchngo
&REDIRECTSECRET=WTX7yn2WAU3Xdm5PuFbUcdKRidZWthpv

Updated 12 months ago