商户接入指引

我要开发

商户应阅读开发文档和API文档,商户完成商户端系统的开发。

了解开发配置信息

在开发之前,你需要知道一些一网通支付的开发配置信息,这些开发配置信息是商户的身份凭证,你需要妥善保管好这些凭证,并且尽可能通过配置进行管理,以便后续调整。

以下是对开发配置信息的说明:

●分行号、商户号

标识商户的唯一ID,由招商银行统一分配。

●商户支付密钥

商户的身份凭证,用于交易报文的签名、验签和加密等,商户在“商户服务平台”自行管理。

●招行公钥

一般情况下,银行主动发送的通知报文使用招行私钥签名。商户接受到请求报文后需要使用招行公钥验签。
招行公钥会定期更换,但更换频率比较低。商户可通过API每天获取一次并存在本地,每次验签时使用即可,建议每天凌晨2:15发起查询招行公钥请求更新公钥。

了解功能接口

如下接口列表中,实现要求为"必须"的接口,要求商户必须完成开发并测试通过。

接口名称说明实现要求(可选/必须)备注
一网通支付客户首次一网通支付时,商户必须为客户生成一网通支付协议号,招行系统将引导客户先进行绑卡签约,再完成支付。非首次支付时,商户传送已签约的客户协议号,客户输入支付密码等信息后完成支付。必须第一次需绑卡签约;后续客户直接支付即可。集成在商户APP中的H5页面
成功签约结果通知客户签约成功后,银行系统会向商户指定的通知地址发送签约结果通知。必须商户Server端实现
成功支付结果通知客户支付成功后,银行系统会向商户指定的通知地址发送支付结果通知。必须商户Server端实现
查询单笔订单查询支付订单的状态等信息。商户未收到支付结果通知的情况下,如需确认订单状态,可以通过单笔订单查询接口查询订单状态。必须商户Server端实现
签约单独的签约功能,商户如需向客户提供单独的签约功能,可通过该接口实现。可选集成在商户APP中的H5页面
支付协议查询查询客户一网通支付协议是否已经成功签署,如果银行未正常返回客户的签约结果,商户可通过该接口主动发起查询。可选商户Server端实现
取消支付协议商户如需提供取消客户协议功能,可对接该接口。可选商户Server端实现
按商户订单日期查询已结账订单按商户订单日期查询批量订单明细。注意:查询结果不包含退款信息。可选商户Server端实现
查询入账明细查询商户入账明细,商户系统应以招行入账明细为准进行对账,对账不平的交易进行退款或请款协商。商户也可登录“商户服务平台”查询入账明细。可选商户Server端实现
退款该接口可选对接。商户也可登录“商户服务平台”执行退款。可选商户Server端实现
查询退款该接口可选对接。商户也可登录“商户服务平台”查询退款信息。可选商户Server端实现