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 about setting up your merchant business type, see Getting started.

How AliPay works

Alipay streamlines the payment experience and minimizes processing costs. The following outlines 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

J.P. Morgan requires the following fields and input parameters in your AliPay payment request transaction: 

  • 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

Payments methods overview
Authorize and capture a payment
Notifications API