H5支付接口规范与实施指南

"H5支付API接口文档1" 本文档详细介绍了H5支付API接口的规范，主要包括H5支付交易接口、请求应答接口、支付结果通知接口以及单笔交易查询接口，适用于支付宝H5支付、微信H5支付和QQH5支付。以下是这些接口的详细说明： 1. **H5支付交易接口** - 目的：让商户网站能够与支付平台进行H5支付交互，提交交易订单数据。 - 接口参数定义：交易请求地址为`https://api.suifupay.com/gateway/api/h5apipay`，要求以HTTPS POST方式提交UTF-8编码的数据。 - 公用业务扩展参数（extend_param）允许商户传递额外信息。 - 错误码定义：具体错误代码见附录，用于处理接口调用过程中可能出现的问题。 2. **请求应答接口** - 描述：此接口回应商户的支付请求，返回一个H5API支付地址，商户可将此地址在手机浏览器上打开以启动支付流程。 - 返回数据：正常情况和异常情况分别有不同的XML数据格式。 3. **支付结果通知接口** - 目的：当消费者支付成功后，支付平台通过服务器后台异步通知商户网站交易结果。 - 特性：只在支付成功时发送通知，要求商户系统收到通知并处理完成后打印"SUCCESS"以确认接收成功。 4. **单笔交易查询接口** - 描述：用于查询特定交易的状态，帮助商户确认交易是否完成或查看交易详情。 - 接口参数定义：包含请求所需的各种交易相关信息。 - 响应参数定义：返回交易状态和其他相关信息。 附录中包含了以下内容： - 网关地址：用于商户发起请求的支付网关URL。 - 签名规则：确保数据安全，防止篡改，商户需遵循此规则生成和验证签名。 - 错误码定义：详尽的错误代码列表，便于商户排查问题。 该文档提供了全面的H5支付API接口指南，帮助开发者正确地集成支付功能到商户网站，实现用户在手机浏览器上的便捷支付，并能及时获取交易状态，保证了交易过程的安全性和可靠性。