API REFERENCE
Schnellzahlung
Parameter
| Parameter | Type | Beschreibung | Erforderlich |
|---|---|---|---|
| data.pay_method | string | offline | ✓ |
| data.sub_pay_method | string | WeChat Pay,Alipay,UnionPay QRcode,通过接口[获取sub pay method](/yabandpay/docs/v3-cn/payments/simplepay/subpaymethod) 获取。**如果为空(推荐),将由YabandPay来做支付方式判断。** | — |
| data.order_id | string | 商户订单号 | ✓ |
| data.amount | string | 金额数字。例如 € 24.99 应该写成24.99,CNY金额>=1,欧元金额>=0.1 | ✓ |
| data.tip_amount | string | 总金额中包含的小费,金额数字。例如 1.02 | — |
| data.currency | string | 货币代码,ISO 4217,例如EUR,CHF | ✓ |
| data.demo | string | 自定义字段 | — |
| data.auth_code | string | 微信支付或者支付宝+钱包的授权码 | ✓ |
| data.description | string | 订单描述 | ✓ |
| data.notify_url | string | 支付完成后异步通知地址 | — |
Für Zahlungen im Geschäft; unterstützt WeChat Pay und Alipay+.
| Feld | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| user | String | Kassiererkonto UID | Erforderlich |
| sign | String | Signature | Erforderlich |
| method | String | v3.BarcodePayment | Erforderlich |
| time | Long | Timestamp | Erforderlich |
- Parameter
| Feld | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| pay_method | String | offline | Erforderlich |
| sub_pay_method | String | WeChat Pay, Alipay oder UnionPay-QR-Code. Rufen Sie ihn über Unterzahlungsmethode abrufen. If left empty (recommended), YabandPay identifies the Zahlungsmethode. | Optional |
| order_id | String | Händlerbestellnummer | Erforderlich |
| amount | String | Betrag als numerische Zeichenfolge. Geben Sie beispielsweise 24.99 for € 24.99. CNY amount >=1; EUR amount >=0.1. | Erforderlich |
| tip_amount | String | Tip included in the total amount, as a numeric string; for example 1.02 | Optional |
| currency | String | ISO 4217 Währungscode, zum Beispiel EUR oder CHF | Erforderlich |
| demo | String | Benutzerdefiniertes Feld | Optional |
| auth_code | String | Autorisierungscode aus dem WeChat-Pay- oder Alipay+-Wallet | Erforderlich |
| description | String | Bestellbeschreibung | Erforderlich |
| notify_url | String | URL für asynchrone Benachrichtigung nach der Zahlung | Optional |
Signaturbeispiel:
Nach Parametern sortierte Werte, verkettet zu einer URL-ähnlichen Abfragezeichenfolge
"amount=2.1&auth_code=134443133735495918¤cy=EUR&demo=test&description=YabandPay test&method=v3.BarcodePayment¬ify_url=https://www.yabandpay.com/notify&order_id=202488465489451317&pay_method=offline&sub_pay_method=WeChat Pay&time=1555499083&tip_amount=0.5&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.BarcodePayment",
"time": 1555499083,
"data": {
"amount": "2.1",
"tip_amount": "0.5",
"auth_code": "YOUR_AUTH_CODE",
"currency": "EUR",
"demo": "test",
"description": "YabandPay test",
"notify_url": "https://www.yabandpay.com/notify",
"order_id": "YOUR_ORDER_ID",
"pay_method": "offline",
"sub_pay_method": "WeChat Pay"
}
}
Eintwortbeispiel:
{
"status": true,
"code": "200",
"data": {
"order_id": "YOUR_ORDER_ID",
"trade_id": "511444d0-2d91-5396-9e34-f2900e80d715",
"amount": "2.1",
"tip_amount": "0.5",
"sub_pay_method": "WeChat Pay",
"state": "paid"
},
"message": ""}
Zusätzliche Informationen:
Eintwortergebnis:
Tipp
- Wenn der Kunde kein Passwort eingeben muss, wird das Zahlungsergebnis synchron zurückgegeben.
- Wenn der Kunde nach dem Scannen des Codes ein Passwort eingeben muss, lautet das Zahlungsergebnis state: processing. Der Händler muss alle Bestellabfrage every 5 Sekunden die [Bestellabfrage] aufrufen, um das tatsächliche Zahlungsergebnis zu ermitteln.
- Wenn der Kunde abbricht oder nicht innerhalb von 30 Sekunden bezahlt, empfehlen wir, die Abfrageschleife zu beenden und Cancel Payment aufzurufen, um die Zahlungstransaktion rückgängig zu machen. Hat der Kunde bereits bezahlt, veranlasst das System automatisch eine Rückerstattung.
Eintwortcodes:
| Status | Code | Message |
|---|---|---|
| true | 200 | Success |
| false | -1000 | Internal error |
| false | -1007 | Identity code is invalid |
| false | -4011 | Not support the payment method |
| false | -4015 | This order has been closed |
| false | -4028 | WeChat Pay is not available |
| false | -4029 | Alipay is not available |
| false | -4086 | Unknow identity code |
