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

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:
- Asking the seller to press Generate QR and scanning the QR code generated by the Seller with the WeChat app:
- Asking the seller to press Scan QR and having the Seller scan the QR code the user generates with their WeChat app: