错误处理

Payout 发起状态定义

如果发起payout请求中缺少必填字段或header信息，可能会返回错误。

错误代码	信息	原因
400	Bad Request	必填字段缺失、参数不匹配或不正确。 例如: “请求 ID 不应重复”
401	Rejected	x-signature 不匹配
403	Forbidden	header 参数缺失，其 认证错误

错误响应示例

状态 400

{
  "status": 400,
  "title": "Constraint Violation",
  "violations": [
    {
      "field": "errors.com.payout.idempotency_error",
      "message": "Request id should not be duplicated",
      "comment": "requestId: koongpayout79_request_id_4July2023BBB, payoutId: fab29194-5e2f-4929-93d2-64a5af94c64c"
    }
  ]
}

状态 401

{
    "status": 401,
    "violations": [
        {
            "path": "errors.com.payout.unauthorized",
            "message": "Invalid signature"
        }
    ]
}

检查状态

如果检查状态 API 的payout状态为“Failed (失败)” 或 “Rejected (拒绝)”，则会显示这些错误。

Coda状态	Coda错误代码	Coda错误描述
REJECTED	DAILY_LIMIT_EXCESS	每日支付限额已超出,请次日再试。
	INCOMPLETE_DATA	付款信息不完整, 请检查是否已输入所有相关信息并重试。
	INSUFFICIENT_FUNDS	Payout余额不足，无法完成此请求。
	MAX_LIMIT_EXCEED_INTERNAL	请与 Coda 联系以获取更多信息
	INVALID_NAME	姓名包含特殊格式或不支持的字符（例如：粗体、斜体、艺术字体、符号等） 请使用有效姓名重新提交 例如： 以下情况将会被拒绝 ❌ 𝒁𝒂𝒉𝒊𝒅𝒂 𝒑𝒂𝒓𝒗𝒆𝒆𝒏 𝑩𝒆𝒓𝒍𝒍𝒂ꨄ︎ 𝘼𝙧𝙞𝙖𝙬𝙖𝙣 𝙁𝙪𝙖𝙙 以下情况为正常可通过 ✅ Kevin Lehner Vasantha jang محمد يتيم وتيد العنزي

Coda状态	Coda错误代码	Coda错误描述
FAILED	BENEFICIARY_REJECTED	收款人拒绝付款。若为误操作, 请重新提交payout请求。
	EXTERNAL_ERROR	请联系 Coda支持团队。
	INCOMPLETE_DATA	付款详细信息不完整。请检查您是否已输入所有相关详细信息，然后重试。
	INTERNAL_ERROR	请联系 Coda支持团队。
	INVALID_ACCOUNT	帐户已关闭、已冻结或处于非活动状态。请咨询您的提供商，并在您的帐户处于活动状态时重试。
	INVALID_ACCOUNT_DETAILS	帐户详细信息无效。请检查您的帐户详细信息，然后重试。
	INVALID_ACCOUNT_NUMBER	帐号无效。请使用有效的帐号重新提交。
	INVALID_AMOUNT	无效金额。请以有效的输入金额重新提交。
	INVALID_BANK_CODE	银行代码无效。请使用有效的银行代码重新提交。
	INVALID_CURRENCY	无效的货币。请检查发送和接收货币是否均受支持且有效。
	INVALID_DATA	付款详细信息无效。请检查您输入的所有详细信息是否正确，然后重试。
	INVALID_DATE	日期无效。请检查日期格式或日期的有效性。
	INVALID_ID	身份证无效。请使用有效的国民身份证重试。
	INVALID_NAME	名称无效，不允许使用符号。请使用有效的姓名重新提交。
	INVALID_PHONE	电话号码无效。请使用有效的电话号码重试。
	MAX_ACCOUNT_LIMIT_EXCEED	您的账户已超出最高支付限额, 请在重试前检查账户限额设置。
	MAX_COUNT_EXCEED	您的交易次数已超限。请检查账户限制设置，稍后再尝试。
	MAX_LIMIT_EXCEED	金额已超过上限, 请修改输入金额后重试。
	NOT_VODAFONE_CASH	该手机号未注册 Vodafone Cash 钱包, 请提供正确的移动运营商信息。 （注：此提示仅适用于埃及地区Payout）
	SUCCESS_TO_FAILED	Payout状态为“成功”，但最终因收款银行拒绝而更改为“失败”。请重新提交您的payout请求并提供正确的详细信息。 （注：此类最终状态变更仅适用于沙特阿拉伯地区的银行转账付款）