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¬ify_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"
}
更多信息:
返回结果:
若调用成功,则返回
"status": true若调用失败,则返回
"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 |