卡密直采供应商

适用于一手官方充值卡供货,非卡密寄售,请与商务沟通确认对接文档

请求方式

全接口请求、返回使用post application/json请求,编码格式utf8

cards加密方式

加密密钥为商户密钥的前32位 AES/ECB/PKCS5Padding 128位 结果hex转大写,cards所有接口请勿明文传递

sign签名计算方式

请求全参数ascii从小到大排序,例如a=1&b=2&key=商户密钥,商户密钥末尾拼接,md5后转小写,空参数与sign不参与签名

cards加密方式

解密方法

Java解密

php解密

sign 计算方法

cards 为list,标准json格式String,aes加密后hex转大写,请勿明文传递

字段类型描述 
cardNoString卡号 
cardPwdString卡密 
expireTimeString有效期(yyyy-MM-dd HH:mm:ss) 
faceInt面值 

创建订单

字段类型示例描述
customerIdInt20001商户编号
orderIdString20221110165331114070采购单号
productCodeStringJW100商品编号(由供应商提供)
productIdInt2048系统商品编号
priceBigDecimal10.0002单价,四位小数
notifyUrlStringhttp://xxx.com回调通知地址
faceInt1000面值(单个面值)
buyNumInt10买入数量,1-100
totalMoneyBigDecimal10000订单总金额(订单完成后结算金额)
signStringb3af409bb8423187c75e6c7f5b68390832位小写md5

返回参数

字段类型示例描述
codeString0订单状态(0=下单成功,1=采购失败,2=未知异常)
messageString采购中提示信息

查询订单

字段类型示例描述
customerIdInt20001商户编号
orderIdString20221110165331114070采购单号
faceInt1000面值(单个面值)
signStringb3af409bb8423187c75e6c7f5b68390832位小写md5

查询订单返回内容

字段类型示例描述
codeint0查询状态(0=查询成功,1=查询失败)
statusint0采购单状态(0=采购成功,1=订单失败,2=处理中)
customerIdint20001商户编号
orderIdstring20221110165331114070采购单号(创建订单orderId一致)
cardsList4C55F88B4D93E60274E599AD1F加密后hex大写
messagestring采购成功提示信息

回调通知

通知地址为创建订单时传递的notifyUrl地址

字段类型示例描述
cardsList4C55F88B4D93E60274E599AD1Fhex后的加密内容
customerIdint20001商户编号
messagestring采购成功提示信息
orderIdstring20221110165331114070采购单号(创建订单orderId一致)
statusstring0采购单状态(0=成功,1=失败)
signstringb3af409bb8423187c75e6c7f5b683908小写32位md5