Skip to content
Create account or Sign in
The Stripe Docs logo
/
Create accountSign in
OverviewUpgrade your integration
Online payments
OverviewFind your use caseUse Managed Payments
In-person payments
Payment methods
Payment scenarios
Beyond payments

Accept a GrabPay payment

Learn how to accept GrabPay, a common payment method in Southeast Asia.

Note

Subscriptions and using GrabPay for future payments aren’t currently supported. Reach out to Stripe support for any support queries on these features.

Caution

Stripe can automatically present the relevant payment methods to your customers by evaluating currency, payment method restrictions, and other parameters.

  • Follow the Accept a payment guide to build a Checkout integration that uses dynamic payment methods.
  • If you don’t want to use dynamic payment methods, follow the steps below to manually configure the payment methods in your Checkout integration.

GrabPay is a single-use payment method. Customers pay with GrabPay by redirecting from your website to GrabPay to authorize the payment. After that, they will automatically be redirected back to your website. You will get immediate notification on whether the payment succeeded or failed.

Assets such as logos and payment buttons are provided in the branding guidelines section.

Determine compatibility

A Checkout Session must satisfy all of the following conditions to support GrabPay payments:

  • Prices for all line items must be in the same currency. If you have line items in different currencies, create separate Checkout Sessions for each currency.
  • You can only use one-time line items (recurring subscription plans are not supported).
  • The sgd currency is supported for businesses based in Singapore.
  • The myr currency is supported for businesses based in Malaysia.

Accept a payment

Note

This guide builds on the foundational accept a payment Checkout integration.

This guides you through enabling GrabPay and shows the differences between accepting a card payment and using GrabPay.

Enable GrabPay as a payment method

When creating a new Checkout Session, you need to:

  1. Add grabpay to the list of payment_method_types
  2. Make sure all your line_items use the same currency
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'grabpay'],
  line_items: [{
    price_data: {
      currency: 'usd',
      # To accept `grabpay`, all line items must have currency: sgd, myr
      currency: 'sgd',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

Fulfill your orders

After accepting a payment, learn how to fulfill orders.

Test your integration

When testing your Checkout integration, select GrabPay as the payment method and click the Pay button.

See also

Was this page helpful?
YesNo