聚合支付API接口文档

扫码支付API接口文档总结

本接口文档主要为汇聚支付的合作商户提供扫码支付、H5支付、APP支付等API接口的接入说明，旨在帮助商户技术人员快速集成支付功能。文档详细介绍了支付、订单查询、退款等接口的请求参数、应答参数以及签名机制，并提供了常见问题及注意事项，确保商户能够顺利完成支付功能的集成。

你能获得：

• 快速了解汇聚支付提供的各种支付方式及其接入流程。
• 掌握API接口的详细参数和使用方法，减少开发过程中的错误。
• 学习如何处理常见问题，提高支付系统的稳定性和用户体验。

核心内容：

1. 支付接口

• 业务功能：买家在商户网站选择付款方式后，商户系统向汇聚支付发送请求数据，汇聚支付根据不同支付方式返回二维码链接、跳转链接等参数，用户进行支付。支付成功后，汇聚支付服务器后台异步通知商户服务器。
• 详细解释：
  • 支付接口是实现交易的核心，支持多种支付方式，如支付宝、微信、银联等。
  • 商户需要根据接口文档构造请求参数，并发送到汇聚支付的指定入口。
  • 汇聚支付处理请求后，会返回相应的支付信息，如二维码地址或跳转链接。
  • 用户完成支付后，汇聚支付会通过异步通知告知商户支付结果。
• 行动建议：
  • 仔细阅读请求参数列表，确保每个参数都填写正确。
  • 根据实际业务需求选择合适的支付方式。
  • 配置正确的异步通知地址，以便及时获取支付结果。

2. 订单查询接口

• 业务功能：根据商户订单号查询该商户订单在汇聚支付平台的支付结果。
• 详细解释：
  • 订单查询接口用于商户查询订单的支付状态，确保交易的准确性。
  • 商户需要提供商户编号和订单号作为查询参数。
  • 汇聚支付会返回订单的详细信息，包括支付状态、支付金额等。
• 行动建议：
  • 在支付完成后，如果未收到异步通知，可以使用订单查询接口确认支付状态。
  • 定期查询订单状态，确保交易数据的准确性。

3. 退款接口

• 业务功能：商户针对某一个已经成功支付的订单发起退款，操作结果在同一会话中同步返回。
• 详细解释：
  • 退款接口允许商户对已完成的交易进行退款操作。
  • 退款可以全额退款或部分金额退款。
  • 退款接口需要提供商户编号、原支付订单号、退款订单号和退款金额等参数。
  • 退款成功后，资金会原路退回用户的支付账户。
• 行动建议：
  • 确保退款金额不超过订单金额。
  • 妥善保管退款订单号，以便查询退款状态。
  • 关注退款异步通知，及时了解退款结果。

4. 退款查询接口

• 业务功能：根据商户退款订单号查询该商户订单在汇聚支付平台的退款结果。
• 详细解释：
  • 退款查询接口用于商户查询退款订单的处理状态。
  • 商户需要提供商户编号和退款订单号作为查询参数。
  • 汇聚支付会返回退款订单的详细信息，包括退款状态、退款金额等。
• 行动建议：
  • 在发起退款后，可以使用退款查询接口确认退款状态。
  • 定期查询退款状态，确保退款操作的顺利进行。

5. 签名机制

• 详细解释：
  • 签名机制用于保证数据传输过程中的数据真实性和完整性。
  • 汇聚支付采用MD5或RSA算法进行签名。
  • 商户需要在请求和应答时都进行签名，以确保数据的安全性。
• 行动建议：
  • 仔细阅读签名机制说明，确保签名过程正确无误。
  • 妥善保管商户密钥，防止泄露。
  • 定期更新商户密钥，提高安全性。

问答

Q: 如何获取商户编号和商户密钥？

A: 登录汇聚支付商户后台，在【首页】可以查看商户编号，在【商户中心】-【密钥管理】可以获取商户密钥。

Q: 如何配置回调通知地址？

A: 登录汇聚支付商户后台，依次点击【商户中心】-【商户信息】-【回调通知地址管理】，添加通知类型并输入通知地址。

Q: 支付成功后未收到异步通知怎么办？

A: 可以通过以下途径解决：

• 支付系统会自动补单，定期重新发起通知。
• 使用“订单查询接口”实时查询订单状态。
• 登录汇聚支付商户系统，手动补发异步通知。