商户应阅读开发文档和API文档,商户完成商户端系统的开发。
了解开发配置信息
在开发之前,你需要知道一些一网通支付的开发配置信息,这些开发配置信息是商户的身份凭证,你需要妥善保管好这些凭证,并且尽可能通过配置进行管理,以便后续调整。
以下是对开发配置信息的说明:
●分行号、商户号
标识商户的唯一ID,由招商银行统一分配。
●商户支付密钥
商户的身份凭证,用于交易报文的签名、验签和加密等,商户在“网上商户结账处理系统”自行管理。
●招行公钥
一般情况下,银行主动发送的通知报文使用招行私钥签名。商户接受到请求报文后需要使用招行公钥验签。
招行公钥会定期更换,但更换频率比较低。商户可通过API每天获取一次并存在本地,每次验签时使用即可,建议每天凌晨2:15发起查询招行公钥请求更新公钥。
了解功能接口
如下接口列表中,实现要求为"必须"的接口,要求商户必须完成开发并测试通过。
接口名称 |
说明 |
实现要求(可选/必须) |
备注 |
一网通支付 |
客户首次一网通支付时,商户必须为客户生成一网通支付协议号,招行系统将引导客户先进行绑卡签约,再完成支付。非首次支付时,商户传送已签约的客户协议号,客户输入支付密码等信息后完成支付。 |
必须 |
第一次需绑卡签约;后续客户直接支付即可。集成在商户APP中的H5页面 |
成功签约结果通知 |
客户签约成功后,银行系统会向商户指定的通知地址发送签约结果通知。 |
必须 |
商户Server端实现 |
成功支付结果通知 |
客户支付成功后,银行系统会向商户指定的通知地址发送支付结果通知。 |
必须 |
商户Server端实现 |
查询单笔订单 |
查询支付订单的状态等信息。商户未收到支付结果通知的情况下,如需确认订单状态,可以通过单笔订单查询接口查询订单状态。 |
必须 |
商户Server端实现 |
签约 |
单独的签约功能,商户如需向客户提供单独的签约功能,可通过该接口实现。 |
可选 |
集成在商户APP中的H5页面 |
支付协议查询 |
查询客户一网通支付协议是否已经成功签署,如果银行未正常返回客户的签约结果,商户可通过该接口主动发起查询。 |
可选 |
商户Server端实现 |
取消支付协议 |
商户如需提供取消客户协议功能,可对接该接口。 |
可选 |
商户Server端实现 |
按商户订单日期查询已结账订单 |
按商户订单日期查询批量订单明细。注意:查询结果不包含退款信息。 |
可选 |
商户Server端实现 |
查询入账明细 |
查询商户入账明细,商户系统应以招行入账明细为准进行对账,对账不平的交易进行退款或请款协商。商户也可登录“网上商户结账处理系统”查询入账明细。 |
可选 |
商户Server端实现 |
退款 |
该接口可选对接。商户也可登录“网上商户结账处理系统”执行退款。 |
可选 |
商户Server端实现 |
查询退款 |
该接口可选对接。商户也可登录“网上商户结账处理系统”查询退款信息。 |
可选 |
商户Server端实现 |