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.

Payment Method Properties


Available country codes	MY
Processing (Presentation) currencies	MYR
Settlement currencies	USD
Consumer currencies	MYR
Channel member tag	grabpaymy
Scheme name in the settlement file	GrabPay MY
Minimum transaction amount	MYR 1.01
Maximum transaction amount	MYR 1500
Session timeout	3 hours
Refund	Full, partial and multiple partial refunds are all available.
Refund Validity	90 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 Type	Asynchronous
Sandbox	PPRO-hosted Simulator

Transaction Flow

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

GrabPay MY Integration

Specific input parameters for the TRANSACTION call

Field Name	M/O/C	Type	Description
`specin.email`	M	ascii	The RFC-compliant email address of the account holder
`specin.phone`	M	ascii	Valid 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