Accept an Alipay payment
Learn how to accept Alipay payments, a digital wallet popular with customers from China.
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.
Alipay is a single-use payment method where customers are required to authenticate their payment. Customers pay by redirecting from your website or app, authorize the payment through Alipay, then return to your website or app where you get immediate notification on whether the payment succeeded or failed.
Determine Compatibility
To support Alipay payments, a Checkout Session must satisfy all of the following conditions:
- 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 aren’t supported.
Accept a payment
Note
Build an integration to accept a payment with Checkout before using this guide.
This guide describes how to enable Alipay and shows the differences between accepting a card payment and using Alipay.
Enable Alipay as a payment method
When creating a new Checkout Session, you need to:
- Add
Alipay
to the list ofpayment_
.method_ types - Make sure all
line_
use the same currency.items
Fulfill your orders
After accepting a payment, learn how to fulfill orders.
Test your integration
When testing your Checkout integration, select Alipay as the payment method and click the Pay button.
Handle refunds and disputes
The refund period for Alipay is up to 90 days after the original payment.
Alipay has no dispute process—customers authenticate with their Alipay account.