成功交易回调通知
用户支付成功后,Coda系统会触发回调到您在Coda后台配置的回调地址,以通知最新订单状态。
在支付流程中,订单交易状态将是以下之一:
处理中 (Pending)
成功 (Successful)
失败 (Failed)
每当订单交易被更新为“成功”或“失败”时,您将通过在Coda后台中配置的回调URL(Complete Notification URL)收到通知。
前提条件
在Coda后台中配置了回调URL(Complete Notification URL)。请参阅开始支付渠道设置以获取详细指导,后台更改会即时更新。
这是一个 Web 应用程序 URL,使用 HTTP/1.1 - GET 方法,并包含以下 HTTP 参数。
回调参数
回调将发送到您在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 次。
若重试机制失败,将通过邮件通知商家。
示例
订单状态双重验证
我们强烈建议商家使用 InquiryPaymentResult API 做双重确认 (回调通知 + 订单状态结果成功), 以确保订单成功后才发货
最后更新于
这有帮助吗?