Dokumentation/API-Referenz

API REFERENCE

Schnellzahlung

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

Schnellzahlung

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

Request parameters9

Required fields first

快捷支付

pay_methodRequiredstringdata.pay_methodoffline
amountRequiredstringdata.amount金额数字。例如 € 24.99 应该写成24.99,CNY金额>=1,欧元金额>=0.1
currencyRequiredstringdata.currency货币代码,ISO 4217,例如EUR,CHF
auth_codeRequiredstringdata.auth_code微信支付或者支付宝+钱包的授权码
descriptionRequiredstringdata.description订单描述
Optional parameters 4
sub_pay_methodOptionalstringdata.sub_pay_methodWeChat Pay,Alipay,UnionPay QRcode,通过接口获取sub pay method 获取。如果为空(推荐),将由YabandPay来做支付方式判断。
tip_amountOptionalstringdata.tip_amount总金额中包含的小费,金额数字。例如 1.02
demoOptionalstringdata.demo自定义字段
notify_urlOptionalstringdata.notify_url支付完成后异步通知地址

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

Parameter

ParameterTypeBeschreibungErforderlich
data.pay_methodstringoffline✓
data.sub_pay_methodstringWeChat Pay,Alipay,UnionPay QRcode,通过接口[获取sub pay method](/yabandpay/docs/v3-cn/payments/simplepay/subpaymethod) 获取。**如果为空(推荐),将由YabandPay来做支付方式判断。**—
data.order_idstring商户订单号✓
data.amountstring金额数字。例如 € 24.99 应该写成24.99,CNY金额>=1,欧元金额>=0.1✓
data.tip_amountstring总金额中包含的小费,金额数字。例如 1.02—
data.currencystring货币代码,ISO 4217,例如EUR,CHF✓
data.demostring自定义字段—
data.auth_codestring微信支付或者支付宝+钱包的授权码✓
data.descriptionstring订单描述✓
data.notify_urlstring支付完成后异步通知地址—

Für Zahlungen im Geschäft; unterstützt WeChat Pay und Alipay+.

FeldTypBeschreibungErforderlich
userStringKassiererkonto UIDErforderlich
signStringSignatureErforderlich
methodStringv3.BarcodePaymentErforderlich
timeLongTimestampErforderlich
  • Parameter
FeldTypBeschreibungErforderlich
pay_methodStringofflineErforderlich
sub_pay_methodStringWeChat Pay, Alipay oder UnionPay-QR-Code. Rufen Sie ihn über Unterzahlungsmethode abrufen. If left empty (recommended), YabandPay identifies the Zahlungsmethode.Optional
order_idStringHändlerbestellnummerErforderlich
amountStringBetrag als numerische Zeichenfolge. Geben Sie beispielsweise 24.99 for € 24.99. CNY amount >=1; EUR amount >=0.1.Erforderlich
tip_amountStringTip included in the total amount, as a numeric string; for example 1.02Optional
currencyStringISO 4217 Währungscode, zum Beispiel EUR oder CHFErforderlich
demoStringBenutzerdefiniertes FeldOptional
auth_codeStringAutorisierungscode aus dem WeChat-Pay- oder Alipay+-WalletErforderlich
descriptionStringBestellbeschreibungErforderlich
notify_urlStringURL für asynchrone Benachrichtigung nach der ZahlungOptional

Signaturbeispiel:

Nach Parametern sortierte Werte, verkettet zu einer URL-ähnlichen Abfragezeichenfolge

"amount=2.1&auth_code=134443133735495918&currency=EUR&demo=test&description=YabandPay test&method=v3.BarcodePayment&notify_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

  1. Wenn der Kunde kein Passwort eingeben muss, wird das Zahlungsergebnis synchron zurückgegeben.
  1. 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.
  1. 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:
StatusCodeMessage
true200Success
false-1000Internal error
false-1007Identity code is invalid
false-4011Not support the payment method
false-4015This order has been closed
false-4028WeChat Pay is not available
false-4029Alipay is not available
false-4086Unknow identity code