WeChat Pay iOS Component

This page explains how to add WeChat Pay to your existing iOS Components integration.

Our WeChat Pay iOS Component renders WeChat Pay in your payment form and triggers the app switch from your app to the WeChat app on the shopper's device.

Requirements

Select the server-side flow that your integration uses:

Preparation

Before starting your WeChat Pay integration:

1. Create a developer account on the WeChat Open Platform.
2. Register your mobile app with WeChat.
3. In Xcode, go to File > Project Settings > App Target > Info, and:
   1. Under URL Types, go to URL Schemes, and add your registered WeChatPay app ID with identifier weixin .
   2. Go to LSApplicationQueriesSchemes, and add weixin.

4. Add WeChat Pay to CocoaPods or Carthage.

   CocoaPods

   Add pod 'Adyen/WeChatPay' to your Podfile.

   Carthage

   Add AdyenWeChatPay.framework to:

   • app "build settings"/"Build Phases"/"Embed Frameworks".
   • app "build settings"/"Build Phases"/"Link Binary to Libraries".
   • app "build settings"/"Build Phases"/"Dependencies".

API reference

You do not need to send additional fields for WeChat Pay. 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

Test and go live

WeChat Pay currently has no test platform. If you have a personal WeChat account you can test your integration by either:

• Canceling the transaction when you are asked to verify the payment (recommended).
• Making live WeChat Pay payments with a low value.

You can check the status of a WeChat Pay payment in your Customer Area > Transactions > Payments.

Before you can accept live WeChat Pay payments, you need to submit a request for WeChat Pay in your live Customer Area.

See also