易销卡卡类支付接口api技术说明文档

《易销卡卡类支付接口api技术说明文档》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、易销卡卡类接口说明文档(单卡)易销卡卡类接口说明文档（单卡）版本:3.0发布日期:2011-08-29螃蟹网络科技有限公司易销卡卡类接口说明文档(单卡)目录第一章文档描述31、文档说明32、阅读对象3第二章系统原理31、术语定义32、消费流程33、查询流程54、系统加密5第三章卡类接口定义61、上行过程接口定义（商户系统发起请求）62、下行过程接口定义（易销卡接口发起请求）8第四章查询流程接口定义11第五章订单外部查询独立网址11附录1：易销卡卡类接口卡类型说明13附录2：易销卡卡类接口区域限制说明14附录3：易销卡卡类接口返回状态说明15易销卡卡类接口说明

2、文档(单卡)第一章文档描述1、文档说明本说明文档用于指导易销卡商户实现与易销卡卡类接口的顺利对接。请相关技术人员详细阅读本手册。2、阅读对象商户开发人员。螃蟹网络科技有限公司易销卡卡类接口相关技术人员。第二章系统原理1、术语定义商户：指已独立拥有在线销售系统，并成为易销卡接口系统会员，且已使用或者将使用易销卡接口实现收付费或其他相关功能需求的企业或者个人。外部接入接口：指易销卡通过统一的方式接受外部请求的接口。商户系统：指使用易销卡外部接入接口的计算机系统，一般指商户所拥有的在线销售系统。用户：指在商户系统内进行消费的企业或者个人。商户ID：指易销卡为使用外

3、部接入接口的商户统一分配的唯一标识。商户密钥：指商户在和易销卡确定合作意向时易销卡为商户提供的32位字符串。该信息作为商户系统和易销卡交互时身份确认的依据，需商户妥善保管。2、消费流程易销卡卡类接口说明文档(单卡)一般在商户系统进行消费时，用户需要向商户支付一定的相关费用。在集成了易销卡接口后，易销卡将为商户提供方便的收付费服务。用户在商户系统发起消费请求后，商户系统和易销卡卡类接口系统（简写为易销卡接口）的交互流程如下图：图1商户系统和易销卡接口交互流程用户的一次消费中，商户系统和易销卡接口之间会发生2次直接交互过程。1、上行过程用户在商户系统选择产品或服

4、务，填写订单（如用户选择卡面值、输入卡号、密码等）后，商户系统将用户填写的信息（如卡号、密码、类型、商户系统订单号等）以及相应的参数（如订单金额、商户ID和密钥、异步通知地址等信息）组织为订单信息，通过http易销卡卡类接口说明文档(单卡)get/post方式提交到易销卡接口，该过程如图1箭头1所示。当商户系统提交订单到易销卡接口时，易销卡接口将同步返回数据给商户系统。商户系统根据该同步返回结果判断订单是否成功提交到易销卡接口。若订单提交成功，商户系统需等待易销卡接口的异步通知结果。注意，在收到异步结果之前，商户系统不能对系统内的订单进行成功或者失败处理。若

5、订单提交失败，商户系统需将系统内订单做失败处理。该过程如图1箭头2所示。1、下行过程易销卡接口将订单处理完成后会异步通知商户系统订单处理结果（通过httpget方式），商户系统需要先验证返回结果的合法性，并根据合法的异步通知的结果，对商户系统的订单进行操作。若异步通知返回充值成功，则商户系统可对订单进行成功操作。注意，实际的订单金额可能和用户提交的订单金额不一致，商户系统必须以易销卡接口异步通知返回的订单实际金额为准。若异步通知返回充值失败，则商户系统可对订单进行失败操作。该过程如图1箭头4所示。商户系统在成功接收易销卡接口异步通知的订单结果后，需同步返回1

6、个结果“opstate=0”（页面内不能有其他的任何代码）给易销卡接口（不论订单结果成功与否），当易销卡接口收到该结果（opstate=0）后便不再通知商户系统，否则易销卡接口将根据同商户的约定重复通知商户系统。该过程如图1箭头5所示。如果商户系统将订单成功提交到易销卡接口后，未收到易销卡接口的异步通知结果，商户可登陆易销卡接口商户系统http://www.exiaoka.com手动重发订单结果通知。需特别注意，当未收到易销卡接口异步通知结果时，商户系统不能对订单状态进行任何操作，否则造成的损失商户自己承担。3、查询流程在商户系统将订单成功提交给易销卡接口后

7、的任意时间，商户系统可发起请求查询订单的处理结果。该流程由商户系统发起，由接口返回相应结果。易销卡卡类接口说明文档(单卡)4、系统加密易销卡接口采用MD5加密方式对传输数据进行签名验证，具体请参考相关接口定义。对MD5加密后的签名值，请注意结果的大小写务必正确。为了确保签名值不是因为MD5加密算法而导致结果不正确，请各商户在调用接口前对字符串1234567890abcdefghijklmnopqrstuvwxyz使用MD5加密算法进行加密，若加密结果为928f7bcdcd08869cc44c1bf24e7abec6则表示MD5加密正常。注：该加密结果值实际为

8、易销卡接口服务器端MD5算法加密后结果。第三章卡类接