WechatPay

Features
Method	Async - GET Redirect
Countries	China
Processing currencies	CHF, CNY, EUR, GBP, USD
Increments	-
Captures	-
Partial/Multiple partial captures	-
Cancels	-
Partial/Multiple partial cancels	-
Refunds	✅
Partial/Multiple partial refunds	✅
Recurring	-
Installments	-
Credits	-
Disputes	-
Min Amount	0.01
Account verification	-

WechatPay is a digital wallet to make online and in-store purchases using their phones. It works as a mobile wallet-based payment method.

When a consumer shops online using the WechatPay payment method, the merchant sends a payment to the PSP.

The merchant redirects to the WechatPay page and allows the customer to complete the purchase.

There are two ways to make WechatPay payments:

• qr_link: the returned redirection URL is a QR link to complete the purchase.

• deep_link: the returned redirection URL is a link to open the WeChat application to complete the purchase.

Constraints

Depending of the merchant country, the list of processing currencies available may vary:

• United Kingdom, Switzerland: CHF, GBP, CNY, EUR, USD
• France, Germany, luxembourg, Hungary, Ireland, Norway, Netherlands: EUR, CNY
• Italy: CNY, EUR, GBP, USD

Payment flow

The payment flow is the same for qr_link and deep_link.

Payment

Request

{
    "processingAccountId": "2HdN2jq6XWmlkhqRC2gDTNYCvNH",
    "merchantReference": "c5211d6b-0178-49f8-a06b-69df097a712f",
    "amount": {
        "value": 200,
        "currency": "cny"
    },
    "paymentMethod": {
        "type": "wechat_pay",
        "wechatPay": {
            "returnUrl": "https://merchant.site/complete-payment",
            "flowType": "qr_link",
            "consumer": {
                "name": "John Doe",
            }
        }
    }
}

Response

{
    "id": "27yiW9MgzBtwiodreuNOXk0rtIw",
    "merchantReference": "c5211d6b-0178-49f8-a06b-69df097a712f",
    "status": "pending",
    "trackingUrl": "/v1/tracks/payments/{trackId}",
    "reason": {
        "code": "required_next_step",
        "description": "An additional step is needed to complete the payment."
    },
    "nextStep": {
        "type": "redirect",
        "redirect": {
            "method": "get",
            "url": "https://payment.method/complete"
        }
    }
}