鼎信代充平台接口文档V1.doc

鼎信代充平台接口文档V2.1版本更新记录序号版本说明1V1.0稳定版本2V2.0更新附录3,状态码列表：新增失败状态码：602（其他原因失败）；修改失败状态码：601（针对移动、电信.电信固话）3V2.11. 壇加固话代充请求接口；2. 代充请求接口增加callbackUrl请求参数，此参数不影响已有对接, 原有商户可根据实际情况增加此参数1. 接口说明1.1商户编号由鼎信提供1.2接口安全机制采用MD5签名以防止信息篡改13接口提交采用http协议,异步返回处理结果1.4本平台共有四个对夕屈口和一个回调啟接口，分别为：代充请求接口；固话代充请求接口；查询订单接口；查询账户余额接口；代充结果回调2. 代充请求接口＞代充请求接口• 汎!址:http : //test i.nmt/dc-txp/recharge• 正式地址:请联系鼎信商务人员•接口参数顺序参数名称参数描述可否为空备注信息1customerNo商户鵜N代充平台商户编号，鼎信提供2requestld订单号N商户订单号必须保证唯一性，长度5-32个字符3proType产品类型N详见【附录1】二J念風留也S四心)的吕曽只相曹舉&.0恳器只宦塑M旧m吕2股理」82S乍1tmn|率平 wm 硬NZzzZXZ5锄a|p 半平平如mobileNo0)0 C•H>0 M aU6 •HS寸LA9卜006O-SS惭吕 SISQm •Ao)uow - PMdpJXMQ - ONPMrtJQ - ONo)r-l-dqow - -a)dAio:Id - PH4s«l)nba)M--K吕应歴如KSQW 茁糾只K-WROgqTTMO。

lx网只團PMdpuz启ONPM3・(拯担起醮能落B血浪吕)赵惭如怕啾A雯圧皿a4)z*a

MD5组合源串如下：customerNo|requestld|proType|proNo|cardNo|cardPwd|money|callbackUrl#key＞固话代充请求接口同步返回：同【代充请求接口】4•代充结果回调代充值订单处理完成后，我方平台会在第一时间内将处理结果以HTTP GET方式回调 商户平台，回调地址为商户在我平台绑走的地址，商户平台在接收到代充值结果后回写 success （请去除不必要的html标记），表明已经接收到数据如果我方平台接收不到商 户的返回信息success ,将间隔一段时间再次发送代充值结果回调信息，直到发送超过一 走次数，我方平台将停止回调通知•参数说明:顺序参数名称参数描述可否为空备注信息1requestld订单号N同请求接口的订单号2customerNo商户编号N商户编号，鼎信提供3orderId鼎信平台订单号N鼎信平台订单号4successAmount代充值成功金额N单位为元5finishDate代充完成时间N格式：yyyyMMddHHmms s6deductAmount扣款手续费N单位为元（扣除商户账户的金额）7actualAmount卡实际面值N充值卡实际对应的面值,单位为元8status状态N见附录39sign城签名N使用MD5算i去生成的加密验证字• sign生成说明：接口采用md5算法对数据逬行数字签名,MD5组合源串如下：requestld|customerNo|orderId|successAmoun11finishDate|deduetAmount i actualAmo tmt|status#key其中key是签名密钥（如没有请联系鼎信商务）。

MD5生成的加密串统一转换为大写注意事项1、 商户获得返回结果，首先根据sign验证各个参数的合法性2、 根据status判断订单是否处理成功r如status为SUCCESS则根据success Amount 及deduct Amount处理本地数据°3、 商户接收到回调通知后，须回写success给我方平台5. 查询订单接口＞查询订单接口• 址:http : //test / dc-txp/query• 正式地址:请联系鼎信商务人员•接口参数顺序参数名称参数描述可否为空备注信息1requestld订单号N同请求接口的订单号（30天以内订单）2customerNo商户编号N商户编号，鼎信提供3sign数据签名N使用MD5算法生成的加密验证字符串• 注意事项查询订单接口只支持30天之内的订单查询，30天以前的订单I各返回订单不存在（返回码400）门青商户人工介入核实• sign生成说明：接口采用md5算法对数据进行数字签名,MD5组合源串如下：customerNo|requestId#key其中key是签名密钥（如没有请联系鼎信商务）MD5生成的加密串统一转换为大写＞查询代充接口同步返回sign参数采用md5算法对返回结果：1进行摘要签名，MD5组合源串如下:我方平台同步返回的查询结果参数如下（以JSON格式返回）：顺序参数名称参数描述可否为空备注信息1resultcode返回码N查询返回结果码,见下表2customerNo商户编号Y商户编号3requestld请求订单号Y商户请求订单号4status代充状态Y见附录35successAmount代充成功金额Y当状态为充值成功时此金额有值,单位元6finishDate代充完成时间Y成功失败状态时有值/ yyyyMMddHHmms s7orderld鼎信平台订单号Y鼎信平台订单号8deductAmount扣款手续费Y单位为元（扣除商户账户的金额）9actualAmount卡实际面值Y充值卡实际对应的面值,单位为元10sign城签名Y使用MD5算法生成的加密验证字符串sign生成说明：resultcode|customerNo|requestld|status|successAmount|finishDate|orderId| deductAmount|actualAmount#key其中Qy是签名密钥（如没有请联系鼎信商务）o MD5生成的加密串统一转换为大写。

＞查询代充接口返回码说明返回码返回码描述信息200系统响应正常400订单不存在（在调用代充提父订单接口，我方无返回结 果时，超过60s查询无此订单，方可将订单置失败或再 次提交）4002参数无效4007商户不存在4008商户状态无效4012商户未设置密钥4013无效的交易签名4016不支持的接口 IP500系统异常• 返回结果说明：返回结果以json方式返回，系统响应正常返回200结果码时的格式如下：Hresul汕200 J,,customerNon :H1234HZHrequestIdH:H1101113453244Hz•'status11 : ” SUCCESS JHsuccessAmount” :HfinishDa:n20151015165748HzHorderIdH:HTEST001H/"deductAmount'1 : ”0 ・ 08H,Hac tualAmount。