WeChat Pay

Intro

WeChat Pay is a Chinese payment feature integrated into the WeChat app. More than 900 million customers use it at least once a month for easy and quick smartphone payments. Your customers pay in CNY, but you will receive the settlement in your local currency.

The integration is very easy and enables your customers to pay swiftly: You send a standard request to our platform to redirect your customers to the WeChat portal, opening their mobile app to confirm the payment.

Your customers need a wallet in the WeChat application linked to a Chinese bank account.

Optimiert für Desktop Mobile

Überblick

Kategorie:

Mobile Zahlungen

Payment Product-ID:

5404

Wichtigste Vorteile

Very popular with users in Asia
Guaranteed payment
Allows refunds

Länder & Währungen

Unterstützte Länder

Australien
Osterreich
Belgien
Bulgarien
Kroatien
Zypern Republik
Tschechien
Danemark
Estland
Finnland
Frankreich
Deutschland
Griechenland
Ungarn
Island
Irland
Italien
Lettland
Liechtenstein
Litauen
Luxemburg
Malta
Niederlande
Norwegen
Polen
Portugal
Rumänien
Slowakei
Slowenien
Spanien
Schweden
Schweiz
Vereinigtes Konigreich

Show all

Unterstützte Währungen

Australischer Dollar
Tschechische Krone
Dänische Krone
Euro
Norwegische Krone
Britisches Pfund
Schwedische Krone
Schweizer Franken
US-Dollar

Integration

We offer this payment methods for the following integration modes. Learn in our dedicated guides about the individual differences:

Find a high level overview in the "Zahlungsablauf" chapter.

Depending on the integration mode, differences apply:

Hosted Checkout Page
Server-to-server

Hosted Checkout Page

Add the following properties to a standard CreateHostedCheckout request:

{
  "order": {
    "amountOfMoney": {
      "currencyCode": "EUR",
      "amount": 1200
    }
  },
  "hostedCheckoutSpecificInput": {
    "locale": "en_GB",
    "returnUrl": " https://yourReturnUrl.com"
   },
  "redirectPaymentMethodSpecificInput": {
    "PaymentProductId": 5404
  }
}

Properties

Remarks

order.amountOfMoney
amount
currencyCode

amount: The gross amount you want to charge for this order.
currencyCode: The ISO 4217 currency code for this amount.

hostedCheckoutSpecificInput
returnURL
locale

returnURL: The URL we redirect your customers to after the payment has been finalized.

locale: The language version of our Hosted Checkout Page.

redirectPaymentMethodSpecificInput.paymentProductId

The numeric identifier of the payment method on our platform. Find this id in the "Überblick" tab. It instructs our platform to send your customers directly to the WeChat Pay portal. If left out, our platform sends your customers to the Hosted Checkout Page instead, allowing them to choose this or any other payment method in your account.

Ausführliche Informationen über dieses Objekt und seine Eigenschaften finden Sie in unserer CreateHostedCheckoutAPI

Server-to-server

Add the following properties to a standard CreatePayment request:

{
   "Order":{
      "AmountOfMoney":{
         "Amount":1200,
         "CurrencyCode":"EUR"
      },
      "Customer":{
         "Device":{
            "IpAddress":"217.149.44.205",
            "UserAgent":"Mozilla/5.0 (Linux; Android 4.4.4; MX4 Pro Build/KTU84P) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/33.0.0.0 Mobile Safari/537.36; 360 Aphone Browser (6.9.7)"
         }
      },
      "References":{
         "MerchantReference":"mr_638143243872475406"
      }
   },
   "RedirectPaymentMethodSpecificInput":{
      "PaymentProductId":5404,
      "redirectionData":{
         "returnURL":"https://yourReturnUrl.com"
      }
   }
}

Properties	Remarks
order.amountOfMoney amount currencyCode	amount: The gross amount you want to charge for this order. currencyCode: The ISO 4217 currency code for this amount.
customer.device ipAdress userAgent	ipAdress: Your customers' IP address. userAgent: Your customers' device used for the transaction. Mandatory for the "With a mobile device" flow to ensure our platform returns an merchantAction.showFormData.paymentProduct5404.appSwitchLink to open the WeChat Pay app on your customers’ device. If left out, our platform returns a merchantAction.showFormData. paymentProduct5404.qrCodeUrl instead for the "With a desktop and a mobile device" flow.
redirectPaymentMethodSpecificInput paymentProductId redirectionData.returnURL	paymentProductId: The numeric identifier of the payment method on our platform. Find this id in the "Überblick" tab. returnURL: The URL we redirect your customers to after the payment has been finalised.
order.customer.contactDetails.emailAddress	Your customer’s e-mail address.

Ausführliche Informationen über dieses Objekt und seine Eigenschaften finden Sie in unserer CreatePaymentAPI

Zahlungsablauf

Depending on your customers' device(s) used, differences apply:

With a desktop and a mobile device
With a mobile device

With a desktop and a mobile device

This flow involves both your customers’ mobile/tablet and desktop device interacting with each other.

Your customers finalise an order in your shop and select WeChat Pay.
You send this CreateHostedCheckout/CreatePayment request to our platform. Depending on your integration mode, differences apply. Check out the "Integration" chapter to find examples for each mode.
You redirect your customers via the redirectUrl to the WeChat Pay portal (For CreateHostedCheckout requests) or display a QR code on your payment page using the merchantAction.showFormData.paymentProduct5404.qrCodeUrl from our response (For CreatePayment requests). Your customers scan the QR code with their mobile/tablet device.
The mobile/tablet device opens the WeChat Pay app. Your customers confirm the payment in the app.
We receive the transaction result.
The mobile/tablet device displays the transaction result in the WeChat Pay app. We redirect your customers to your returnURL on their desktop device.
You request the transaction result from our platform via GetPaymentDetails/GetHostedCheckout or receive the result via webhooks.
If the transaction was successful, you can deliver the goods / service.

With a mobile device

This flow involves only your customers' mobile device.

Your customers finalise an order in your shop and select WeChat Pay.
You send this CreateHostedCheckout/CreatePayment request to our platform. Depending on your integration mode, differences apply. Check out the "Integration" chapter to find examples for each mode.
You redirect your customers via the redirectUrl (For CreateHostedCheckout requests) or the merchantAction.showFormData.paymentProduct5404.appSwitchLink (For CreatePayment requests). The mobile/tablet device opens the WeChat Pay app. Your customers choose their wallet and confirm the payment in the app.
We receive the transaction result.
The mobile/tablet device displays the transaction result in the WeChat Pay app.
You request the transaction result from our platform via GetPaymentDetails/GetHostedCheckout or receive the result via webhooks.
If the transaction was successful, you can deliver the goods / service.

Testdaten

In unseren Testszenarios finden Sie Testdaten und detaillierte Instruktionen.

Stellen Sie sicher, den korrekten Endpunkt anzusteuern und zurück zum Live-Endpunkt zu wechseln, sobald Sie Ihre Tests abgeschlossen haben