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 an Alipay payment

Learn how to accept Alipay payments, a digital wallet popular with customers from China.

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.

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:

  1. Add Alipay to the list of payment_method_types.
  2. Make sure all 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', 'alipay'],
  line_items: [{
    price_data: {
      currency: 'usd',
      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 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.

See also

Was this page helpful?
YesNo