API REFERENCE
Unterzahlungsmethode abrufen
Verwenden Sie diese API zusammen mit der Schnellzahlung.
Tipp
Hinweis: Verwenden Sie die API zum Abrufen von sub_pay_method zusammen mit dem auth_code um festzustellen, ob der Kunde einen WeChat-Pay- oder Alipay+-Code vorgelegt hat.
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| user | String | Kassiererkonto UID | Erforderlich |
| sign | String | Signature | Erforderlich |
| method | String | v3.GetSubPay | Erforderlich |
| time | Long | Timestamp | Erforderlich |
- Parameter
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| auth_code | String | Durch Scannen des QR-Codes im Wallet des Kunden abgerufen | Erforderlich |
Signaturbeispiel:
Nach Parametern sortierte Werte, verkettet zu einer URL-ähnlichen Abfragezeichenfolge
"auth_code=134443133735495918&method=v3.GetSubPay&time=1555499083&user=YOUR_CASHIER_UID"
Sign stringA using secret_key
The resulting signature is:
"YOUR_SIGNATURE"
Einfragebeispiel:
{
"user": "YOUR_CASHIER_UID",
"sign": "YOUR_SIGNATURE",
"method": "v3.GetSubPay",
"time": 1555499083,
"data": {
"auth_code": "YOUR_AUTH_CODE"
}
}
Eintwortbeispiel:
{
"status": true,
"code": "200",
"data": {
"sub_paymethod": "Wechat Pay"},
"message": ""}
Codetypen und Regeln
Wechat Pay
Ein 18stelliger dynamischer Zahlencode zur Identifizierung eines WeChat-Pay-Nutzers. Er beginnt mit 10, 11, 12, 13, 14, or 15 und muss in Echtzeit aus dem WeChat-Wallet des Kunden ausgelesen werden.
Alipay+
Alipay+-Zahlungscodes gibt es in vier Varianten: Alipay+-Codes mit 19Stellen, CGCP-Codes, AlipayCN-Codes und AlipayHK-Codes. Die folgende Tabelle beschreibt die Typen und ihre Regeln.
QuickPass
Base64-kodiertes Format (standardmäßige QR-Code-Zeichenfolge aus der QuickPass-App)
| Typ | Rules |
|---|---|
| Alipay+ 19-digit code | Beginnt mit 28. Die dritte Ziffer ist immer 9, und die sechste Ziffer vom Ende ist immer 6. Beispiel: 2893612204263667830. |
| CGCP code | Beginnt mit 25, 26, 27, 28, 29, or 30, followed by a 1-digit protocol ID identifying the MPP (1 by default) and a 3-digit routing number. Beispiel: 281010897274821897274821, where the routing number is 010. |
| AlipayCN code | Länge: 16 to 24 digits. Beginnt mit 25, 26, 27, 28, 29, or 30. Beispiel: 28024456785672301. |
| AlipayHK code | Länge: 17 to 19 digits. Beginnt mit 25, 26, 27, 28, 29, or 30. Beispiel: 280244567856723026. |
| UnionPay Base64 code (native QuickPass payment code) | Eine Base64-kodierte Zeichenfolge, die üblicherweise beginnt mit hQVD, Sie enthält Groß- und Kleinbuchstaben, Ziffern, +, / sowie abschließende =-Auffüllzeichen. Es gibt keine feste Länge. Dekodieren Sie die Zeichenfolge und prüfen Sie die UnionPay-Protokollkennung. Beispiel: hQVDUFYwMWFWTwigAAADMwEBAlcRYlFkJZZFSTbVASIBUYcYCIljM4ICAACfEBEHAQEDoAAAAQgwMDI1MDAwMZ8mCFbpVlAj7RlynycBgJ82Ar/nnzcEPEEZil80AQE= |
