This page explains how to add Alipay to your existing iOS Components integration.
Requirements
Select the server-side flow that your integration uses:
Requirement | Description |
---|---|
Integration type | Make sure that you have built a Sessions flow iOS Components integration. |
Setup steps | Before you begin, add Alipay in your Customer Area. |
API reference
You do not need to send additional fields for Alipay. To see optional fields that you can send for all payment methods, choose the endpoint you integrated:
- /sessions: This is the default with Components v5.0.0 or later.
- /payments: If you implemented an additional use case.
Component configuration
v5.0.0 or later
If your integration uses iOS Components v5.0.0 or later, configure and create an instance of the Alipay Component:
let paymentMethods = session.sessionContext.paymentMethods // Check that the payment method is supported before showing the Component. guard let paymentMethod = paymentMethods.paymentMethod(ofType: .other("alipay_wap")) else { return } let component = InstantPaymentComponent(paymentMethod: paymentMethod, context: context, order: nil) self.currentComponent = component // Set the session as the delegate. component.delegate = session component.initiatePayment()
v4.x.x
If your integration uses an earlier version of iOS Components:
// Check that the payment method is supported before showing the Component. guard let paymentMethod = paymentMethods.paymentMethod(ofType: AlipayPaymentMethod.self) else { return } let style = FormComponentStyle() let component = AlipayComponent(paymentMethod: paymentMethod, apiContext: context, style: style) present(component)
There are no configuration steps specific to Alipay required for Components.
Test and go live
We recommend doing live penny tests:
- Get an Alipay wallet app, set it up with a credit or debit card, and do live penny tests (payments for a minimal amount).
- View the details of your Alipay test payments in your live Customer Area > Transactions > Payments.
Before you can accept live Alipay payments, you need to submit a request for Alipay in your live Customer Area.