鼎信销卡接口文档.doc

(卡信息加密)参数已被删除,cardNumber(卡号)、(卡密)不能明文提交。加密方式详见【销卡接口请求】。(签名)中,isEncrypt需要删除。sign生成详见【销卡接口请求】。【销卡接口返回】新增1019的返回码。【查询支付接口】新增返回码。莃薂薁螈螅羁莁薅袄蒀莆袁薀莈螂羂虿袇薂蝿螇芇芃螁腿蚆肃袂芈肅螃蚀蚀薅薄1、。。,异步返回支付结果芄2、销卡接口螂销卡接口请求袇蚈接口地址:/,鼎信提供羆2芆customerOrderId蒀订单号袈N莅商户订单号必须保证唯一性,长度小于30位螂3薁cardType羇产品编码螄N蒂编码列表见附表2薃4艿amount蒈卡面额膃N莀单位为元蒇5袇cardNumber羃卡号(暗码)蒁N螀使用客户后台设置的加密密钥进行3DES加密莇6蚄cardPassword薃卡密码(暗码)袈N螆使用客户后台设置的加密密钥进行3DES加密蒄7莀callback芁回调地址膅N膄处理完成后将通过此地址进行结果通知莂8荿sign蚅签名羅N蒃使用MD5算法生成的加密验证字符串蒇9芈extendInfo蚅扩展信息芀Y袀商户扩展信息,返回时原样返回螇蒅cardNumber(卡号)、cardPassword(卡密)加密说明:节进行3DES加密。注:加密密钥不足24位长度时后面补0,超过24位长度时需截取前24位字符。羈将加密后的密文进行hex转换。膇袂sign生成说明: 接口采用md5算法对请求数据验证,验证失败将不予处理。MD5组合源串如下:customerNumber|customerOrderId|cardType|amount|cardNumber|cardPassword|callback|key|其中key为在鼎信商户后台设置的签名密钥。MD5生成的加密串统一转换为小写。3DES及MD5测试结果比对:MD5测试结果比对:中文测试数据:这是测试数据加密结果:71328cb3738b49a2e80abd355fb2ee30不带中文测试数据:test-exiaoka加密结果:913708bf0f561863de1851271faf68573DES测试结果比对:密钥:test901234测试数据:1789加密结果:3c45aac44b04660fe688ead959d6ed48232fa26d4f836f40销卡接口返回返回0000则为提交成功,返回其他为失败,具体失败原因如下:1001失败次数过多1002商户未设置密钥1003商户不存在1004商户已关闭1005系统异常1006未开通的业务1007商户编号为空1008必要参数为空1009数据签名无效1010请求金额不支持1011业务类型不支持1012卡种为空1013电信地方卡不支持1014该卡密已经在系统成功过1015卡密处理中1016商户服务费率没设置1017卡号密码规则错误或金额不支持1018订单号重复1019参数无效(回调地址格式不正确,订单号长度不小于30)3、销卡结果通知鼎信将在第一时间将处理结果以Http方式发送到商户提交的callback参数的地址中,客户在接收到支付结果后向页面写入“ess”(请去除不必要的html标记),表明已经接收到数据,如果鼎信接收不到商户的返回信息”ess”,将间隔一段时间再次发送售卡结果通知信息,直到发送超过一定次数,鼎信将停止发送结果通知。参数说明:ESS=成功、FAILED=失败6finishDate处平台处时间N平台处理完成的时间,格式为:yyyyMMddHHmmss7returnCode返回码N附录18extendInfo扩展信息Y同订单提交时的扩展信息9sign数据签名N使用MD5算法生成的加密验证字符串sign生成说明: 接口采用md5算法对数据进行数字签名,MD5组合源串如下:customerNumber|customerOrderId|essAmount|status|finishDate|returnCode|key|其中key为在鼎信商户后台设置的签名密钥。MD5生成的加密串统一转换为小写。、商户获得返回结果,首先根据sign验证各个参数的合法性。2、根据status判断卡是否处理成功,essAmount来处理本地数据.