Documentatie/API-referentie

API REFERENCE

Snelle betaling

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

Snelle betaling

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.

Parameters

ParameterTypeBeschrijvingVerplicht
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支付完成后异步通知地址—

Voor betalingen in winkels, met ondersteuning voor WeChat Pay en Alipay+

VeldTypeBeschrijvingVerplicht
userStringKassiersaccount UIDVerplicht
signStringSignatureVerplicht
methodStringv3.BarcodePaymentVerplicht
timeLongTimestampVerplicht
  • Parameters
VeldTypeBeschrijvingVerplicht
pay_methodStringofflineVerplicht
sub_pay_methodStringWeChat Pay, Alipay, UnionPay QRcode. Haal dit op via Get sub pay method. Als u dit veld leeg laat (aanbevolen), bepaalt YabandPay de betaalmethode.Optioneel
order_idStringBestel-ID van de handelaarVerplicht
amountStringBedrag als numerieke tekenreeks. Voer bijvoorbeeld 24.99 in voor € 24.99. Het CNY-bedrag moet >=1 zijn; het EUR-bedrag >=0.1.Verplicht
tip_amountStringFooi inbegrepen in het totaalbedrag, als numerieke tekenreeks; bijvoorbeeld 1.02Optioneel
currencyStringISO 4217 currency code, for example EUR or CHFVerplicht
demoStringCustom fieldOptioneel
auth_codeStringAuthorization code from the WeChat Pay or Alipay+ walletVerplicht
descriptionStringOrder descriptionVerplicht
notify_urlStringAsynchronous notification URL after paymentOptioneel

Signature example:

Sorted parameters concatenated into a URL-style query string

"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"

Request example:

{
    "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"
    }
}

Response example:

{
    "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": ""}

Additional information:

Response result:

Tip

  1. Als de klant geen wachtwoord hoeft in te voeren, wordt het betalingsresultaat synchroon geretourneerd.
  1. Als de klant na het scannen van de code een wachtwoord moet invoeren, is het betalingsresultaat state: processing. De handelaar moet Query Order elke 5 seconden opvragen om het werkelijke betalingsresultaat vast te stellen.
  1. Als de klant annuleert of niet binnen 30 seconden heeft betaald, raden we aan de opvraaglus te beëindigen en Cancel Payment aan te roepen om de betaling ongedaan te maken. Als de klant al heeft betaald, voert het systeem automatisch een terugbetaling uit.
Response codes:
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