Skip to main content

Alipay

Alipay is an eWallet available to customers with a Chinese bank account and residential status.

Before you begin

Complete the getting started process for J.P. Morgan to set up your merchant’s business type. For more information, refer to Getting started.

Availability

Alipay availability
Payment method Payment type Consumer (country) Merchant (country) Presentment currency
Alipay Wallet CN AT, BE, CH, CY, CZ, DE, DK, ES, FI, FR, GB, GG, GI, IE, IM, IT, JE, LU, MT, NL, NO, PT, SE EUR, GBP, USD

Branding guidelines

For branding guidelines from Alipay, go here.

How Alipay works

Alipay streamlines the payment experience and minimizes processing costs. The following steps outline the Alipay payment process:

  1. On the merchant checkout page, the customer selects Alipay as their preferred method of payment.
  2. You initiate a POST request to the /payments endpoint to submit the payment to Alipay. Note: Ensure the paymentMethodType attribute is set to alipay.

Desktop payments:

  1. J.P. Morgan returns a QR code to you. 
  2. You display the QR code to your consumer.  
  3. Your consumer scans the QR code. Alternatively, they can log in to the Alipay website to make the payment.

Mobile payments:

  1. J.P. Morgan returns a payment link to your mobile website.  
  2. Your mobile website redirects the consumer to the Alipay in-app payment page. 
  3. Your consumer completes the payment in the Alipay app.
Tip

You are notified of the payment result through webhook notifications. To learn more, check out the Notifications API.

Payment parameters

The following fields are required for Alipay:

  • amount
  • currency
  • merchant.merchantSoftware.companyName
  • merchant.merchantSoftware.productName
  • merchant.merchantSoftware.version
  • accountHolder.fullName
  • accountHolder.billingAddress.line1
  • accountHolder.billingAddress.postalCode
  • accountHolder.billingAddress.countryCode
  • paymentMethodType.redirectedPayment.merchantReturnUrl
  • paymentMetadataList.metadataAttribute
  • paymentMetadataList.metadataAttributeValue
Tip

To support a guest shopping experience where you do not have access to the consumer's information, set the accountHolder.fullName to guest shopper and the accountHolder.billingAddress.countryCode to CHN.