鼎信代充平台接口文档V21.docVIP

鼎信代充平台 接口文档 V 2.1 版本更新记录 序号 版本 说明 1 V1.0 稳定版本 2 V2.0 更新附录3，状态码列表： 新增失败状态码：602(其他原因失败); 修改失败状态码：601(针对移动、电信、电信固话)。 3 V2.1 增加固话代充请求接口; 手机代充请求接口增加callbackUrl请求参数，此参数不影响已有对接，原有商户可根据实际情况增加此参数。 接口说明 1.1商户编号由鼎信提供。 1.2接口安全机制采用MD5签名以防止信息篡改。 1.3接口提交采用http 协议,异步返回处理结果。 1.4本平台共有四个对外接口和一个回调通知接口，分别为： 手机代充请求接口； 固话代充请求接口； 查询订单接口； 查询账户余额接口； 代充结果回调。 手机代充请求接口 手机代充请求接口 测试地址：/dc-txp/recharge 正式地址：请联系鼎信商务人员 接口参数 顺序 参数名称 参数描述 可否为空 备注信息 1 customerNo 商户编号 N 代充平台商户编号，鼎信提供 2 requestId 订单号 N 商户订单号必须保证唯一性，长度5-32个字符 3 proType 产品类型 N 详见【附录1】 4 mobileNo 代充号码 N 需要代充值的号码 5 province 省份 N 代充号码所在的省份, 详见【附录2】 6 cardNo 卡号 N 充值卡卡号（3DES加密后的密文） 7 cardPwd 卡密 N 充值卡卡密（3DES加密后的密文） 8 money 卡面额 N 充值卡面额 9 callbackUrl 回调地址 Y 为空时将使用我方平台绑定的地址 为空时不参与签名 (V2.1新增) 10 sign 签名 N 使用MD5算法生成的加密验证字符串 3DES加密说明： 1. 指定的加密运算模式为ECB; 2. 加密算法的填充模式为PKCS7; 3. 提供字节为24位的加密Key（不足24位在后面补0，超过24位截取）; 4. 加密结果做hex编码转换。 3DES测试结果比对： 密钥：test12345678901234 测试数据：1234567890123456789 加密结果：3c45aac44b04660fe688ead959d6ed48232fa26d4f836f40 sign生成说明： 接口采用md5算法对请求数据验证，验证失败将不予处理。MD5组合源串如下： customerNo|requestId|proType|province|mobileNo|cardNo|cardPwd|money#key 其中key是签名密钥（如没有请联系鼎信商务）, cardNo和cardPwd均为密文。MD5生成的加密串统一转换为大写。 callbackUrl不为空时MD5组合源串如下： customerNo|requestId|proType|province|mobileNo|cardNo|cardPwd|money|callbackUrl#key MD5测试结果比对： 测试数据： 123|TEST001|MOBILE|013c45aac44b04660fe688ead959d6ed48232fa26d4f836f40|3c45aac44b04660fe688ead959d6ed48232fa26d4f836f40|100#testKey 加密结果：B264FDA15253C1B52A63A9BEA43AD528 代充请求接口同步返回 返回0000则为订单提交成功，返回其他编码均为失败，具体返回码如下： 返回码 返回码描述信息 0000 订单提交成功 4001 必要参数为空 4002 参数无效 4003 卡号卡密无效 4004 号码无效 4005 地区编码无效 4006 订单号已存在 4007 商户不存在 4008 商户状态无效 4011 商户账户余额不足 4012 商户未设置密钥 4013 无效的交易签名 4014 3DES加密无效 4015 不支持的交易类型 4016 不支持的接口IP 5000 系统异常，未收单 固话代充请求接口 固话代充请求接口 测试地址：/dc-txp/telephone/recharge 正式地址：请联系鼎信商务人员 接口参数 顺序 参数名称 参数描述 可否为空 备注信息 1 customerNo 商户编号 N 代充平台商户编号，鼎信提供 2 requestId 订单号 N 商户订单号必须保证唯一性，长度5-32个字符 3 proType 产品类型 N UNICOM_P