Documentation

GrabPay Singapore

Integrate GrabPay and allow consumers to make a one-time payment using their GrabPay balance by entering their Grab-registered mobile number followed by a 6-digit OTP sent via SMS to their registered mobile phone numbers. PPRO supports GrabPay in two markets currently, Singapore and Malaysia. The following guide covers an integration to GrabPay in Singapore.

Suggest Edits

Payment Method Properties

Available country codesSG
Processing (Presentation) currenciesSGD
Settlement currenciesSGD
Consumer currenciesSGD
Channel member taggrabpayotp
Scheme name in the settlement fileGrabPay
Minimum transaction amountSGD 1.01
Maximum transaction amountSGD 5000 for premium wallet consumers

SGD 1000 for basic wallet consumers
Session timeout1 hour
RefundFull, partial and multiple partial refunds are all available.
Refund Validity1 year
ChargebackNo
Integration TypeAsynchronous
SandboxScheme-hosted

Transaction Flow

  1. The consumer chooses to pay by GrabPay on the merchant website.
  2. You send a Transaction request to PPRO.
  3. PPRO sends GrabPay an Initiate Payment call.
  4. PPRO builds a Redirect URL and sends it to the merchant and consumer.
  5. On the Grab ID authentication page, the consumer enters their Grab-registered mobile number.
    1. The consumer receives an SMS with a 6-digit OTP.
    2. The consumer enters the OTP and gets to the payment details page.
    3. The consumer confirms the payment.
  6. Grabpay sends PPRO a notification.
  7. PPRO returns an OK status. PPRO sends a Confirm Payment to GrabPay.
  8. GrabPay returns a TxID and status.
  9. PPRO sends GrabPay a Check Status call.
  10. GrabPay returns the status.
  11. The consumer is redirected to the success page.
  12. You receive a transaction response.

GrabPay One-Time Payment Integration

Specific input parameters for the TRANSACTION call

There are no specific input parameters for the TRANSACTION call.

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=grabpayotp
&txtype=TRANSACTION
&countrycode=SG
&currency=SGD
&amount=1055
&merchanttxid=emjVAyT64xTB
&login=johndoe
&password=wXBrpVporFVjGO4R
&contractid=JOHNDOE
&channel=testchannel
&merchantredirecturl=https%3A%2F%2Fmerchant.com%2Fwork%2Fppro2%2Flanding.php
&notificationurl=https%3A%2F%2Fmerchant.com%2Fwork%2Fppro2%2Fnotification.php
&accountholdername=John%20Doe
&returnmode=urlencodeext

TRANSACTION call output

REQUESTSTATUS=SUCCEEDED
&STATUS=SUCCEEDED
&TXID=599080927
&ERRMSG=
&CHANNEL=testchannel
&TAG=grabpayotp
&REDIRECTSECRET=nxgMdYP7MLbe0cyMwipHhKjPw1f7lBy2

Updated about 1 year ago