Dokumentation/API-Referenz

API REFERENCE

Unterzahlungsmethode abrufen

POSThttps://mapi.yabandpay.com/Payments
Live API
API PLAYGROUND · Live API

Unterzahlungsmethode abrufen

POSThttps://mapi.yabandpay.com/Payments
Automatically signed with your credentials

Request parameters1

Required fields first

获取sub pay method

auth_codeRequiredstringdata.auth_code通过扫描用户钱包的二维码获得

Credentials stay on this page. Your secret key is never stored or sent to the documentation server.

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.

ParameterTypBeschreibungErforderlich
userStringKassiererkonto UIDErforderlich
signStringSignatureErforderlich
methodStringv3.GetSubPayErforderlich
timeLongTimestampErforderlich
  • Parameter
ParameterTypBeschreibungErforderlich
auth_codeStringDurch Scannen des QR-Codes im Wallet des Kunden abgerufenErforderlich

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)

TypRules
Alipay+ 19-digit codeBeginnt mit 28. Die dritte Ziffer ist immer 9, und die sechste Ziffer vom Ende ist immer 6. Beispiel: 2893612204263667830.
CGCP codeBeginnt 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 codeLänge: 16 to 24 digits. Beginnt mit 25, 26, 27, 28, 29, or 30. Beispiel: 28024456785672301.
AlipayHK codeLä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=