我要开发

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

了解开发配置信息

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

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

●分行号、商户号

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

●商户支付密钥

商户的身份凭证,用于交易报文的签名、验签和加密等,商户在“网上商户结账处理系统”自行管理。

●招行公钥

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

了解功能接口

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

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

关于网站迁移公告


为提供更优质的开发技术支持,本网站已于2019年8月12日正式迁移至新域名http://openhome.cmbchina.com/paynew/pay/Home,敬请访问并收藏。原网站域名已停止更新维护,请以新网站提供的文档信息为准。

由此给您带来的不便,敬请谅解。


招商银行一网通支付技术支持小组

2019年8月12日