CardCheck


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

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

[!TIP|style:flat]

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

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

Method:POST

POST data type:Json

Parameter Type Description Required
user String 收银员账号的UID 必填
sign String 签名 必填
method String v3.CardCheck 必填
time Long 时间戳 必填
  • 参数
Parameter Type Description 是否必填
pay_method String online 必填
sub_pay_method String CardCheck 必填
operation String 3 必填
order_id String 商户的订单ID 必填
description String 订单描述 必填
form_type String 返回的url类型,默认01。 01.completed, 02.iframe 选填
demo String 自定义字段 选填
timeout String 过期时间单位分钟(0-1440) 必填
redirect_url String 支付完成后跳转地址 选填
notify_url String 支付完成后异步通知地址 必填
request_id String 请求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=016683"

得到的 stringA 使用 secret_key做签名

得到的签名如下:

"fe910a99bb9baee3e31ea996c2df76f391f89ca5769d7b7b45a32075af25149e"

提交示例:

{
    "user": "016683",
    "sign": "fe910a99bb9baee3e31ea996c2df76f391f89ca5769d7b7b45a32075af25149e",
    "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": "203040950640690239603690",
        "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": "203040950640690239603690",
        "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,即支付成功;

返回代码:
Status Code Message
true 200
false -1000 Internal error
false -403 The signature Error
false -2001 The user not exist
false -3001 Required field is missing
false -4118 Incorrect request ID

results matching ""

    No results matching ""