鑫亿宝H5支付接入规范详解

需积分: 0 0 下载量 134 浏览量 更新于2024-08-04 收藏 97KB DOCX 举报
"鑫亿宝H5支付接入规范V1.0.21" 鑫亿宝H5支付接入规范是针对商户系统与支付平台之间交互的一个详细指南,旨在帮助商户实现用户通过H5页面进行支付的功能。这个规范包含了支付流程、通信约定、接口定义以及安全策略等关键要素。 一、支付流程 1. 用户在商户平台上选择商品或服务并提交订单。 2. 商户系统根据订单信息调用鑫亿宝的H5支付接口,生成支付链接(payUrl)。 3. 支付链接被传递给用户,用户在手机上打开该链接,进入支付页面完成支付。 4. 订单提交时间(orderTime)以N14格式记录,即年月日时分秒的组合,例如20230417163000。 5. 用户完成支付后,鑫亿宝会发送支付通知报文给商户系统,商户需验证签名以确认支付的有效性。 二、通信约定 1. 环境说明:商户需与鑫亿宝指定的API环境进行通信。 2. 协议规则:调用API时,参数应按照ASCII字典顺序排列,空值不参与签名,参数名区分大小写。 3. 通信安全:在签名生成过程中,需要遵循特定规则,如忽略签名参数(sign)本身,确保字母大写,并支持接口的扩展字段。 三、数据类型与参数约定 1. 类型定义:接口参数可能包含各种数据类型,如字符串(ANS),数字(N)等。 2. 长度定义:例如,payUrl的长度限制为255个字符。 3. 时区示例:使用如GMT+8表示的时区。 4. 参数命名:所有参数名遵循驼峰命名法,如orderTime。 四、接口参数 1. 必填项:带有*标记的参数是必需的。 2. 扩展字段:接口可能添加新的参数,商户在签名验证时应考虑这些扩展字段。 五、业务流程 1. H5支付流程:商户向支付平台发起下单请求,鑫亿宝响应支付结果。 2. 示例请求和响应报文:提供了请求报文和响应报文的格式示例,帮助商户理解如何构造和解析通信数据。 六、测试与验证 1. 测试环境:鑫亿宝提供测试环境供商户进行联调测试,需要联系运营人员获取测试商户号和密钥。 2. 签名校验:在接收支付通知时,商户需正确验证签名以确保数据的安全性和完整性。 鑫亿宝H5支付接入规范为商户提供了一个清晰的框架,以便于商户与鑫亿宝支付平台的无缝对接,实现安全、高效的移动支付体验。商户需要按照规范中的步骤和要求,进行系统开发和接口集成,以确保支付流程的顺畅运行。