必付宝H5 API技术接口规范v1.0

需积分: 0 0 下载量 23 浏览量 更新于2024-08-05 收藏 288KB PDF 举报
"必付宝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技术接口是一套完整的支付解决方案,它涵盖了支付流程中的关键环节,包括支付发起、结果验证和用户交互,同时强调了安全性,通过签名机制确保交易数据的准确性和完整性。开发者在接入时,需要遵循其接口规范,确保所有必要的参数正确无误,同时实现签名算法和异步通知处理逻辑,以实现顺畅的支付体验。