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 automatically presents your customers payment method options by evaluating their currency, payment method restrictions, and other parameters. We recommend that you configure your payment methods from the Stripe Dashboard using the instructions in Accept a payment.
If you want to continue manually configuring the payment methods you present to your customers with Checkout, use this guide. Otherwise, update your integration to configure payment methods in the Dashboard.
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:
- Add
grabpay
to the list ofpayment_
method_ types - Make sure all your
line_
use the same currencyitems
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.