傲付数卡点卡商城 API点卡接口开发 商户接口规范 版本(2.0.0).docxVIP

傲付数卡点卡商城API点卡接口说明

傲付数卡点卡商城API点卡接口开发

商户接口规范

版本(2.0.0)

目录

第一章文档描述 3

1、文档说明 3

2、阅读对象 3

第二章系统原理 3

1、术语定义 3

2、消费流程 4

3、查询流程 5

4、系统加密 5

第三章点卡接口定义 5

1、同步过程接口定义（商户系统发起请求） 5

2、下行异步通知过程接口定义（接口发起请求） 7

附录1：傲付数卡点卡商城支付接口卡类型说明 9

第一章文档描述

1、文档说明

本说明文档用于指导傲付数卡点卡商城API商户实现与傲付数卡点卡商城API点卡接口的顺利对接。请相关技术人员详细阅读本文档。

2、阅读对象

商户开发人员。

傲付数卡点卡商城API点卡接口相关技术人员。

第二章系统原理

1、术语定义

商户：指已独立拥有在线销售系统，并成为傲付数卡点卡商城API点卡接口系统会员，且已使用或者将使用傲付数卡点卡商城API点卡接口实现收付费或其他相关功能需求的企业或者个人。

外部接入接口：指傲付数卡点卡商城API通过统一的方式接受外部请求的接口。

商户系统：指使用傲付数卡点卡商城API外部接入接口的计算机系统，一般指商户所拥有的在线销售系统。

用户：指在商户系统内进行消费的企业或者个人。

商户ID：指傲付数卡点卡商城API为使用外部接入接口的商户统一分配的唯一标识。

商户密钥：指商户在和傲付数卡点卡商城API确定合作意向时傲付数卡点卡商城API为商户提供的16位字符串。该信息作为商户系统和傲付数卡点卡商城API交互时身份确认的依据，需商户妥善保管。

傲付数卡点卡商城API点卡接口说明

2、消费流程

一般地，在商户系统进行消费时，用户需要向商户支付一定的相关费用。在集成了傲付数卡点卡商城销卡接口后，傲付数卡点卡商城销卡将为商户提供方便的收付费服务。

用户在商户系统发起消费请求后，商户系统和傲付数卡点卡商城销卡卡类接口系统（简写为傲付数卡点卡商城接口）的交互流程。

具体地，用户的一次消费中，商户系统和傲付数卡点卡商城接口之间会发生2次直接交互过程。

1、同步过程

用户在商户系统选择产品或服务，填写订单（如用户选择卡面值、输入卡号、密码等）后，商户系统将用户填写的信息（如卡号、密码、类型、商户系统订单号等）以及相应的参数（如订单金额、商户ID和密钥、异步通知地址等信息）组织为订单信息，通过httpget/post方式提交到傲付数卡点卡商城接口，该过程如图1箭头1所示。

当商户系统提交订单到傲付数卡点卡商城接口时，傲付数卡点卡商城接口将同步返回数据给商户系统。商户系统根据该同步返回结果判断订单是否成功提交到傲付数卡点卡商城接口。若订单提交成功，商户系统需等待傲付数卡点卡商城接口的异步通知结果。注意，在收到异步结果之前，商户系统不能对系统内的订单进行成功或者失败处理。若订单提交失败，商户系统需将系统内订单做失败处理。该过程如图1箭头2所示。

2、异步过程

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

商户系统在成功接收傲付数卡点卡商城接口异步通知的订单结果后，需同步返回1个结果“ok”（页面内不能有其他的任何代码）给傲付数卡点卡商城接口（不论订单结果成功与否），当傲付数卡点卡商城接口收到该结果“ok”后便不再通知商户系统，否则傲付数卡点

傲付数卡点卡商城API点卡接口说明

卡商城接口将根据同商户的约定重复通知商户系统。该过程如图1箭头5所示。

如果商户系统将订单成功提交到傲付数卡点卡商城接口后，未收到傲付数卡点卡商城接口的异步通知结果，商户可登陆傲付数卡点卡商城接口商户系统手动重发订单结果通知。需特别注意，当未收到傲付数卡点卡商城接口异步通知结果时，商户系统不能对订单状态进行任何操作，否则造成的损失商户自己承担。

3、查询流程

在商户系统将订单成功提交给傲付数卡点卡商城接口后的任意时间，商户系统可发起请求查询订单的处理结果。该流程