回调通知详情
用户支付成功后，Coda系统会触发回调到您在Coda后台配置的回调地址，以通知最新订单状态。
在支付流程中，订单交易状态将是以下之一：
Pending（待处理）
Successful（成功）
Failed（失败）
每当订单交易被更新为“成功”或“失败”时，您将通过在Coda后台中配置的回调URL(Complete Notification URL)收到通知。
前置条件
在Coda后台中配置了回调URL(Complete Notification URL)。请参阅 开始支付渠道设置 以获取详细指导，后台更改会即时更新。
回调参数
回调将发送到您在Coda后台中配置的回调URL，并附加以下查询参数。
TxnId
固定返回 从支付请求发起返回的Coda订单ID。
OrderId
固定返回 您在支付请求发起时传递的订单ID
*OriginAmount
*此字段仅在 v2.0 API 版本中，根据特殊请求返回
可选
在发起请求时提供的金额
*OriginCurrency
*此字段仅在 v2.0 API 版本中，根据特殊请求返回
可选
ISO 4217 字母代码（如 USD、IDR 等）。在发起请求时用于指定商品价格的货币。
OriginCurrency可能与PayCurrency不同。
*PayAmount
*此字段仅在 v2.0 API 版本中，根据特殊请求返回
可选
以PayCurrency为单位计费给用户的最终价格。 注意：TotalPrice始终等于PayAmount。
*PayCurrency
*此字段仅在 v2.0 API 版本中，根据特殊请求返回
可选 ISO 4217字母代码（USD、IDR等）。用于实际支付并向用户收费的货币。
*SubTotalPrice
*此字段仅在 v2.0 API 版本中，根据特殊请求返回
可选
税前交易净金额。
计算方式为：totalPrice / (1 + payTaxRate)。该数值表示不包含当地服务费或数字税的商品基础价格。
*PayTaxRate
*此字段仅在 v2.0 API 版本中，根据特殊请求返回
可选）
该字段表示应用于该笔交易的税率百分比（例如：0.08 表示 8%）。该数值会根据商户配置、当地税收法规或用户的具体位置（邮政编码）动态确定。
resultDesc
固定返回
resultDesc 参数用于帮助商户准确分析并处理交易失败的原因。
如果 resultCode 等于 0，resultDesc 将返回 “Success（成功）”。
如果 resultCode 表示错误，resultDesc 将提供该错误的详细描述。
ResultCode
固定返回 ResultCode将帮助指示交易的状态。
ResultCode = 0 表示交易成功。
ResultCode = 431 481 或 216 表示交易待处理
所有其他ResultCode值表示交易失败。您可以在 常见错误代码 找到完整的错误代码及描述。
TotalPrice
固定返回 用户为订单交易支付的总金额。此金额将始终以本地货币计算。
PaymentType
固定返回 客户选择的支付类型。 PaymentType等于支付渠道ID，或者当支付渠道为运营商支付时，等于1。
Checksum
固定返回 校验和有助于验证消息是否由Codapay发送的，并且未被篡改。有关如何使用此值的更多信息，请参阅安全指南。
MnoId
固定返回
如果在支付渠道初始化过程中使用了need_mno_id参数，则此参数将包含支付渠道ID。
USDPrice
固定返回 如果在USD不是本地货币的国家发起交易，则Coda回调参数（TotalPrice）将默认显示用户的本地货币金额。
如果您需要在回调中添加初始的USDPrice，请联系Codapay技术团队。
预期响应
❗️商家在收到Coda订单回调成功支付通知后，并成功发货后需回复"ResultCode=0"（字符串）
示例：
NotifyURL="商家回调地址TxnId=Coda订单号&OrderId=商家orderID&TotalPrice=金额&PaymentType=渠道号&ResultCode=0&Checksum=xxxxx", MResp="ResultCode=0"
❗️若 Coda 未收到 ResultCode=0 的回复，将启动重试机制：
系统会每隔 5 分钟重试一次，总共重试 3 次。
若重试机制失败，将通过邮件通知商家。
若要订阅交易通知，请前往 Publisher Portal： 团队 > 管理访问权限 > 勾选“Transaction Notification” > 保存更改。
示例
失败交易通知
除了成功交易通知外，Codapay 还支持失败交易通知。
如果一笔交易未能达到成功状态，系统也会向已配置的“交易完成通知 URL”发送通知，其中包含相关的交易详情。
启用方式：失败交易通知默认未开启。如需启用此功能，请联系您的 Coda 客户经理或发送邮件至 codapay_integration@coda.co 联系集成支持团队。
示例
订单状态双重验证
我们强烈建议商家使用 InquiryPaymentResult API 做双重确认 (回调通知 + 订单状态结果成功), 以确保订单成功后才发货
最后更新于
这有帮助吗？