二维码支付

适用于线下门店支付场景

[!TIP|style:flat]

请将返回的url（或将url转换成二维码）以及可用支付方式的icon展示给用户。

API URL：https://mapi.yabandpay.com/Payments

Method：POST

POST data type：Json

参数 类型 描述 是否必填
user String 收银员账号的UID 必填
sign String 签名 必填
method String v3.QRcodePayment 必填
time Long 时间戳 必填
  • 参数
Parameter Type Description 是否必填
pay_method String offline 必填
sub_pay_method String QRcode 必填
order_id String 商户的订单ID 必填
amount String 金额数字。例如 € 24.99 应该写成24.99，CNY金额>=1，欧元金额>=0.1 必填
tip_amount String 总金额中包含的小费，金额数字。例如 1.02 选填
currency String 货币代码，ISO 4217，例如EUR，CHF 必填
description String 订单描述 必填
demo String 自定义字段 选填
timeout String 过期时间单位分钟(0-1440) 必填
redirect_url String 支付完成后跳转地址 选填
notify_url String 支付完成后异步通知地址 必填

签名示例：

拼接为URL方式并排序后的字符串

 "amount=12.1&currency=EUR&demo=test&description=YabandPay test&method=v3.QRcodePayment&notify_url=https://www.yabandpay.com/notify&order_id=202486556498441613&pay_method=offline&redirect_url=https://www.yabandpay.com&sub_pay_method=QRcode&time=1555498137&timeout=0&tip_amount=0.5&user=016683"

得到的 stringA 使用 secret_key做签名

得到的签名如下：

"942d93b552837560c365544593216888f534519edef2cd4b0e0080a4ccff8947"

提交示例：

 {
  "user": "016683",
  "sign": "942d93b552837560c365544593216888f534519edef2cd4b0e0080a4ccff8947",
  "method": "v3.QRcodePayment",
  "time": 1555498137,
  "data": {
    "amount": "12.1",
    "currency": "EUR",
    "tip_amount": "0.5",
    "demo": "test",
    "description": "YabandPay test",
    "notify_url": "https://www.yabandpay.com/notify",
    "order_id": "202486556498441613",
    "pay_method": "offline",
    "redirect_url": "https://www.yabandpay.com",
    "sub_pay_method": "QRcode",
    "timeout": "0"
  }
}

返回示例：

{
  "status": true,
  "code": "200",
  "data": {
    "order_id": "202486556498441613",
    "trade_id": "4552eeea-1ae8-1e40-3b4b-802dc2f5686a",
    "amount": "12",
    "currency": "EUR",
    "tip_amount": "0.5",
    "url": "https://pay.yabandpay.com/payments/selectpay/order/ODlmYmYyMzQtN2U1Yy00ZDI5LTM5NWMtNGI4NzljYjI4MDlj",
    "available_payment_methods": "Alipay+, Wechat Pay, iDEAL, UnionPay, QuickPass, Bancontact, Visa, Mastercard, ApplePay, GooglePay",
    "state": "processing"
  },
  "message": "",
}

更多信息：

返回结果：

  1. 若调用成功，则返回"status": true

  2. 若调用失败，则返回"status": false

我们强烈建议同时使用订单查询和异步通知来同步和更新支付状态，以确保支付信息的实时准确性。

返回代码：
Status Code Message
true 200 Success
false -1000 Internal error
false -3001 Required field is missing
false -403 The signature Error
false -4011 Not support the payment method

results matching ""

    No results matching ""