Skip to content
On this page

卡密导入接口

通过该接口可以将卡密导入到E绑卡平台API卡池,商户可以通过API卡池创建绑卡任务,从而完成卡密核销。

接口说明

  1. 接口是异步处理,接口调用成功(卡密导入成功,不代表绑卡成功,最终结果会异步回调进行通知或通过订单查询结果获取最终订单处理结果。)
  2. 下单接口如果请求超时,请调用订单查询接口确认下单结果。
  3. 可设置超时自动取消,timeout字段(单位分钟),如果传递该参数,则订单在timeout分钟内未处理,自动取消并发起回调通知。
  4. 购卡折扣,当绑卡任务的充卡折扣不小于购卡折扣时才会进行任务绑卡操作。

接口地址

/openapi/importCard

请求参数

参数名称类型必填示例值(加密前)描述
app_keystring64c234be34a34应用app Key
customer_order_nostring1689736728外部订单号,请确保订单号唯一
product_codestringJDE产品编码,管理后台【产品管理】获取
card_faceint50卡密面值
card_nostring9070247051131562875卡号,需要加密传递
card_secretfloat123456卡密 ,需要加密传递
bid_discountstring92.5购卡折扣取值范围0~100
timeoutint1超时时间单位分钟,超时未处理会自动取消
notify_urlinthttps://xxx.com回调通知地址
timestampint1689736728请求时间戳
signstring参见样例签名,参见签名规则

请求数据样例

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错误"
}