Payment-method icon

GrabPay Drop-in integration

Add GrabPay to your Drop-in integration.

This page explains how to add GrabPay to your existing Web Drop-in integration.

Requirements

Select the server-side flow that your integration uses:

To make a GrabPay PayLater payment, you also need to collect and send additional information:

  • The delivery address.
  • Information about the purchased items.

API reference

Collecting and sending additional information is only needed for GrabPay PayLater payments. However, we highly recommend you do the same in your initial integration for GrabPay Wallet because it will help save development resources if you plan to enable GrabPay PayLater afterwards.

To make a GrabPay PayLater payment, either postpaid or installment, you need to send additional fields. Select which endpoint you are using:

Drop-in configuration

There are no configuration steps specific to GrabPay required for Drop-in.

Test and go live

You can test your GrabPay integration in two ways: with the Adyen Payment Simulator, or directly with GrabPay.

Test with Adyen

Use the Adyen Payment Simulator to verify that your GrabPay integration works correctly with Adyen. You can test during development, before you go live, and after launch. The simulator does not recreate the shopper's journey through the GrabPay app or website.

This testing option is available by default when you add GrabPay in your test Customer Area. The payment method type is grabpay_SG.

To test a redirect payment:

  1. Start a payment as usual in your integration. The shopper is redirected to an Adyen-hosted simulator page.
  2. Select the payment outcome that you want to test.
  3. Wait for the simulator to return the shopper to your website, then complete the payment as usual. For an Advanced flow, make a /payments/details request.
  4. Confirm that your integration handles the outcome that you selected, and that the payment appears in your Customer Area > Payments > Payment list.

Test directly with GrabPay

To test directly with GrabPay:

  1. Contact our Support Team for your test wallet credentials.
  2. In the simulator, log in to Grab with the phone number you registered, and specify the one-time password that you receive on that phone number.

Check the status of direct GrabPay test payments in your Customer Area > Payments > Payment list.

Before you can accept live GrabPay payments, you need to submit a request for GrabPay in your live Customer Area.

See also