跳转到主要内容
本节详细介绍 Localpayment API 的 API 响应格式、HTTP 状态码,以及所有交易状态和错误代码的完整参考。掌握这些响应模式和代码对于构建稳健的集成、准确跟踪交易生命周期、处理各种场景以及提供清晰的用户反馈至关重要。 Localpayment API 的响应通过 HTTP 状态码和结构化状态对象清晰地指示请求结果。虽然不同 endpoint 的响应结构可能有所不同,但它们始终包含正确处理请求的关键信息。

HTTP状态码

指示请求成功或失败的标准 HTTP 状态码

状态对象

交易结果的详细状态信息

清晰的错误处理

用于调试和解决的结构化错误信息

HTTP状态码

API 使用标准的 HTTP 状态码来指示协议层面的请求结果。这些代码初步表明您的请求是否成功。

成功代码(2xx)

客户端错误(4xx)

服务器错误(5xx)


状态对象

status 对象提供有关交易结果的详细、Localpayment 特定信息,并包含在大多数涉及金融操作的 API 响应中。

状态对象结构

状态对象字段


常见响应模式

付款成功回复

错误响应模式


交易状态和错误指南

请在下方选择特定交易类型,查看其状态和错误代码的详细列表。

Payin

通过虚拟账户、Columns cols= 和 APM 接收资金的状态和错误代码。

Payout

向受益人汇款的状态和错误代码。

退款

退款状态和错误代码。

拒付

争议交易和强制撤销的状态和错误代码。

退回

退回付款和结算失败的状态和错误代码。

召回

付款召回和撤销的状态和错误代码。

贷方

信用交易和调整的状态和错误代码。

借方

借记交易和资金扣款的状态和错误代码。

订阅

循环计费和订阅生命周期的状态和错误代码。

货币兑换

外汇交易状态和错误代码。

Wire In

汇入电汇的状态和错误代码。

Wire Out

汇出电汇的状态和错误代码。

开支

费用扣除和支出交易的状态和错误代码。

定期费用

定期收费的状态和错误代码。

Webhooks 指南

了解如何接收实时状态更新

错误处理

处理失败交易的指南

支持

获取有关特定状态问题的帮助
专业提示实施全面的日志记录,记录状态码和错误码及其时间戳。这能为合规性要求创建清晰的审计跟踪,并显著加快问题调试速度。日志中应包含完整的错误响应,而不仅仅是错误码。

最后修改于 2026年11月10日