文档中心/API 接口

API REFERENCE

CardCheck

POSThttps://mapi.yabandpay.com/Payments
实际接口
API PLAYGROUND · 实际接口

CardCheck

POSThttps://mapi.yabandpay.com/Payments
填写凭据后自动签名

请求参数10

先填写必填项

CardCheck

pay_method必填stringdata.pay_methodonline
sub_pay_method必填stringdata.sub_pay_methodCardCheck
operation必填stringdata.operation3
description必填stringdata.description订单描述
timeout必填stringdata.timeout过期时间单位分钟(0-1440)
notify_url必填stringdata.notify_url支付完成后异步通知地址
request_id必填stringdata.request_id请求id需保持唯一,建议24以上位数字+字母
可选参数 3
form_type可选stringdata.form_type返回的url类型,默认01。 01.completed, 02.iframe
demo可选stringdata.demo自定义字段
redirect_url可选stringdata.redirect_url支付完成后跳转地址

凭据仅在当前页面使用。secret_key 不保存,也不发送给文档服务器。

对持卡人发起 0 元授权,用于校验提供卡号,需持卡人提供有效信息完成验证

可使用YabandPay提供的托管页面完成验证。它使商家能够通过在 YabandPay 系统上托管敏感的 PCI DSS数据来安全地接受请求。

小贴士

可以通过查询.获得验证结果

ParameterTypeDescriptionRequired
userString收银员账号的UID必填
signString签名必填
methodStringv3.CardCheck必填
timeLong时间戳必填
  • 参数
ParameterTypeDescription是否必填
pay_methodStringonline必填
sub_pay_methodStringCardCheck必填
operationString3必填
order_idString商户的订单ID必填
descriptionString订单描述必填
form_typeString返回的url类型,默认01。 01.completed, 02.iframe选填
demoString自定义字段选填
timeoutString过期时间单位分钟(0-1440)必填
redirect_urlString支付完成后跳转地址选填
notify_urlString支付完成后异步通知地址必填
request_idString请求id需保持唯一,建议24以上位数字+字母必填

签名示例:

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

"description=cardcheck test&form_type=01&method=v3.CardCheck&notify_url=https://www.yabandpay.com/notify&operation=3&order_id=203040950640690239603690&pay_method=online&redirect_url=https://www.yabandpay.com/redirect_url&request_id=tscqf7ki76o7aem4z1yl1xs72f89fptl&sub_pay_method=CardCheck&time=1720680417&timeout=0&user=YOUR_CASHIER_UID"

得到的 stringA 使用 secret_key做签名

得到的签名如下:

"YOUR_SIGNATURE"

提交示例:

{
    "user": "YOUR_CASHIER_UID",
    "sign": "YOUR_SIGNATURE",
    "method": "v3.CardCheck",
    "time": 1720680417,
    "data": {
        "description": "cardcheck test",
        "form_type": "01",
        "timeout": "0",
        "pay_method": "online",
        "sub_pay_method": "CardCheck",
        "operation": "3",
        "order_id": "YOUR_ORDER_ID",
        "redirect_url": "https://www.yabandpay.com/redirect_url",
        "notify_url": "https://www.yabandpay.com/notify",
        "request_id": "tscqf7ki76o7aem4z1yl1xs72f89fptl"
    }
}

返回示例:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "YOUR_ORDER_ID",
        "trade_id": "160899f3-f6d9-a8d8-ab5b-82eacdab9c5b",
        "amount": "0.00",
        "currency": "EUR",
        "url": "https://pay.yabandpay.com/payments/callback/order/MTYwODk5ZjMtZjZkOS1hOGQ4LWFiNWItODJlYWNkYWI5YzVi",
        "state": "processing"
    },
    "message": "",
    "response_id": "202407111544200649155078"
}

更多信息:

返回结果:
  1. 若调用成功,则返回"status": true

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

你需要跳转返回的url。用户在此url输入卡号信息并完成支付后,会同步跳转回redirect_url。我们强烈建议同时使用订单查询和异步通知来同步和更新支付状态,以确保支付信息的实时准确性。 a) 如果订单状态state为paid,即支付成功;

返回代码:
StatusCodeMessage
true200
false-1000Internal error
false-403The signature Error
false-2001The user not exist
false-3001Required field is missing
false-4118Incorrect request ID