"必付宝H5api技术接口v1.0 (2)2"
必付宝的H5API技术接口是一套用于实现H5支付、异步回调和订单查询等功能的接口规范,主要面向具备TCP/HTTP协议基础的开发人员。文档详细介绍了接口的使用方法、安全规范以及加密规则。
1. 文档说明:
- 简介:文档旨在定义H5收款、支付结果通知和订单查询接口的数据传输规则。
- 阅读对象:主要是为开发第三方代收付功能的技术人员设计,要求对TCP/HTTP协议有基本理解。
- 接口清单:包括H5支付接口、支付结果异步通知接口和支付页面返回接口。
2. 接入说明:
- 协议规则:所有接口通过HTTP POST方式提交,使用UTF-8编码,返回数据为JSON格式。
- 安全规范:采用MD5加密的签名方式,请求和响应都需要进行签名校验以确保身份的真实性。
- 加密规则:将参数按ASCII顺序排列,去除空值和sign字段,用key=value形式连接,再加上预设的密钥生成签名。
3. 接口规范:
- H5支付接口:接口URL为http://s3.av8dpay.com/bifubao-gateway/front-pay/h5-pay.htm,包含多个请求参数,如MERCHANT_ID(商户号)、TRAN_CODE(订单流水号)、TRAN_AMT(订单金额)、REMARK(商品描述)、TYPE(支付类型)等。其中,TYPE支持QQH5、京东H5、银联WAP、支付宝H5、微信H5、银联H5等支付方式。BANK_ACCOUNT_NO(银行卡号)仅在TYPE为银联H5时必填,NO_URL(通知地址)和RET_URL(返回地址)用于异步通知和支付完成后跳转。
4. 安全性:
- 为了保证交易的安全,必付宝要求在请求和响应中都进行签名验证,防止数据被篡改。MD5加密是一种常见的哈希算法,可以确保数据的完整性。
5. 兼容性:
- 接口支持多种支付方式,适应不同用户的需求,如移动支付巨头的H5接口和银联的H5支付。
6. 异步通知与回调:
- NO_URL参数用于指定异步通知地址,支付完成后,必付宝会将支付结果发送到这个地址,以便商户系统进行后续处理。
- RET_URL则用于支付成功后,将用户重定向回商户设定的网页。
总结,必付宝的H5API技术接口是一套完整的支付解决方案,它涵盖了支付流程中的关键环节,包括支付发起、结果验证和用户交互,同时强调了安全性,通过签名机制确保交易数据的准确性和完整性。开发者在接入时,需要遵循其接口规范,确保所有必要的参数正确无误,同时实现签名算法和异步通知处理逻辑,以实现顺畅的支付体验。