Appearance
卡密导入接口
通过该接口可以将卡密导入到E绑卡平台API卡池,商户可以通过API卡池创建绑卡任务,从而完成卡密核销。
接口说明
- 接口是异步处理,接口调用成功(卡密导入成功,不代表绑卡成功,最终结果会异步回调进行通知或通过订单查询结果获取最终订单处理结果。)
- 下单接口如果请求超时,请调用订单查询接口确认下单结果。
- 可设置超时自动取消,timeout字段(单位分钟),如果传递该参数,则订单在timeout分钟内未处理,自动取消并发起回调通知。
- 购卡折扣,当绑卡任务的充卡折扣不小于购卡折扣时才会进行任务绑卡操作。
接口地址
/openapi/importCard
请求参数
参数名称 | 类型 | 必填 | 示例值(加密前) | 描述 |
---|---|---|---|---|
app_key | string | 是 | 64c234be34a34 | 应用app Key |
customer_order_no | string | 是 | 1689736728 | 外部订单号,请确保订单号唯一 |
product_code | string | 是 | JDE | 产品编码,管理后台【产品管理】获取 |
card_face | int | 是 | 50 | 卡密面值 |
card_no | string | 否 | 9070247051131562875 | 卡号,需要加密传递 |
card_secret | float | 是 | 123456 | 卡密 ,需要加密传递 |
bid_discount | string | 是 | 92.5 | 购卡折扣取值范围0~100 |
timeout | int | 否 | 1 | 超时时间单位分钟,超时未处理会自动取消 |
notify_url | int | 否 | https://xxx.com | 回调通知地址 |
timestamp | int | 是 | 1689736728 | 请求时间戳 |
sign | string | 是 | 参见样例 | 签名,参见签名规则 |
请求数据样例
json
{
"app_key": "64df2d0b286a5",
"customer_order_no": 1693290190,
"product_code": "JDE",
"card_face": 50,
"bid_discount": 97,
"timeout": 1,
"card_secret": "U1MRFs6LAIz1gyKpVbDw8p7k5MJ+NUdI",
"notify_url": "https:\/\/www.ebangka.com\/test\/notify",
"timestamp": 1693290190,
"sign": "8ae73e1ab00afabe9d4b2b45faa9a6a2"
}
提交成功数据响应
json
{
"code": 0,
"data": {
"order_no": "20909458523684864"
},
"message": "数据提交成功"
}
提交失败数据响应
json
{
"code": 70002,
"data": "",
"msg": "app_key错误"
}