- METHOD TYPEMobile Payments
- PAYMENTS
- PAYOUTS
- REFUNDS
- RECURRING
Introduction
WeChat supports deposits and refunds for Chinese citizens with Chinese bank accounts and accounts on the WeChat app. Although it is possible to make purchases and get refunds worldwide with WeChat, users must be based in China.
There are three varying payment flows using WeChat: QR scanning, Quickpay, and WeChat accounts. All flows involve using the WeChat app.
Supported Countries
- China
Supported Currencies
- CNY
- EUR
- GBP
- USD
Chinese Yuan is a transactional currency only, not a settlement currency.
Payment (Deposit) Flow
Follow these steps to perform a payment using Nuvei REST API integration:
1. Generate a sessionToken
Press here for details.
2. Send a /payment
Request
Perform the payment by sending a /payment
request with its mandatory parameters including:
userTokenId
amount
currency
paymentOption.alternativePaymentMethod
block containing:paymentMethod
: “apmgw_WeChat“
deviceDetails
block containing:ipAddress
billingAddress
block containing:firstName
,lastName
,country
,email
userDetails
block containing:firstName
,lastName
,country
,email
Example /payment
Request
{ "sessionToken":"<sessionToken from /getSessionToken>", "merchantId":"<merchantId>", "merchantSiteId":"<merchantSiteId>", "clientUniqueId":"<unique transaction ID in merchant system>", "clientRequestId":"<unique request ID in merchant system>", "amount":"200", "currency":"USD", "userTokenId":"<unique customer identifier in merchant system>", "paymentOption":{ "alternativePaymentMethod":{ "paymentMethod":"apmgw_WeChat" } }, "deviceDetails":{ "ipAddress":"<customer's IP address>" }, "billingAddress":{ "firstName": "John", "lastName": "Smith", "country":"CN", "email":"[email protected]" }, "userDetails":{ "firstName": "John", "lastName": "Smith", "country":"CN", "email":"[email protected]" }, "timeStamp":"<YYYYMMDDHHmmss>", "checksum":"<calculated checksum>" }
After the transaction is processed, Nuvei sends a Direct Merchant Notification (DMN) that includes the result of the transaction to the URL provided in urlDetails.notificationUrl
, which Nuvei recommends including in the /payment
request.
User Experience
Online Flow
- The user is redirected to a page with a QR code.
- The user scans the QR code with the WeChat app to complete the transaction.
POS Flow
- The Seller enters the amount on WeChat app.
- The Seller selects WeChat as the payment method.
- The seller selects either Generate QR or Scan QR.
- The user completes the transaction either by:
Testing
There is no test environment for WeChat.