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