For the complete documentation index, see llms.txt. This page is also available as Markdown.

成功交易回调通知

用户支付成功后,Coda系统会触发回调到您在Coda后台配置的回调地址,以通知最新订单状态。

在支付流程中,订单交易状态将是以下之一:

  • 处理中 (Pending)

  • 成功 (Successful)

  • 失败 (Failed)

每当订单交易被更新为“成功”或“失败”时,您将通过在Coda后台中配置的回调URL(Complete Notification URL)收到通知。

前提条件

在Coda后台中配置了回调URL(Complete Notification URL)。请参阅开始支付渠道设置以获取详细指导,后台更改会即时更新。

回调参数

回调将发送到您在Coda后台中配置的回调URL,并附加以下查询参数。

参数
描述

TxnId

必填 您在发起支付后收集到的Coda订单ID

OrderId

必填 您在支付请求发起时传递的订单ID

ResultCode

必填 ResultCode将帮助指示交易的状态。

ResultCode = 0 表示交易成功。

ResultCode = 431 481 或 216 表示交易待处理

所有其他ResultCode值表示交易失败。您可以在这里找到完整的错误代码及其解释。

TotalPrice

必填 用户为订单交易支付的总金额。此金额将始终以本地货币计算。

PaymentType

必填 客户选择的支付类型。 PaymentType等于支付渠道ID,或者当支付渠道为运营商计费时,等于1。

Checksum

必填 校验帮助验证消息是否由 Codapay 发送,并确保消息未被篡改。有关如何使用此参数的更多信息,请参阅安全指南

USDPrice

可选 如果在美元不是当地货币的国家发起交易,Coda 回调参数(TotalPrice)将默认显示用户的当地货币金额。

如果您需要在回调中添加最初的 USDPrice,请在Coda后台中进行配置。有关更多详情,请参阅USD 订单交易概览

预期响应

❗️商家在收到Coda订单回调成功支付通知后,并成功发货后需回复"ResultCode=0"(字符串)

示例:

NotifyURL="商家回调地址TxnId=Coda订单号&OrderId=商家orderID&TotalPrice=金额&PaymentType=渠道号&ResultCode=0&Checksum=xxxxx", MResp="ResultCode=0"

❗️若 Coda 未收到 ResultCode=0 的回复,将启动重试机制:

  • 系统会每隔 5 分钟重试一次,总共重试 3 次。

  • 若重试机制失败,将通过邮件通知商家。

示例


订单状态双重验证

最后更新于

这有帮助吗?