Error Handling

Payout Initiate Status Definition

Errors can be returned if a mandatory field or a header is missing from the Initiate Payout Request.

Error Code	Message	Reason
400	Bad Request	Mandatory fields are missing, parameter mismatch or incorrect. E.g. “Request id should not be duplicated”
401	Rejected	The x-signatures do not match
403	Forbidden	Header parameter missing, its authentication error

Sample error responses

Status 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"
}
]
}

---

Check Status

These errors will be shown if the payout status is either Failed or Rejected from Check Status API.

Coda Status	Coda Error Code	Coda Error Description
REJECTED	DAILY_LIMIT_EXCESS	The daily payout limit has been exceeded. Please try again the next day.
	INCOMPLETE_DATA	Incomplete Payment Details. Please check that you have input all relevant details and try again.
	INSUFFICIENT_FUNDS	Payout balance has insufficient funds to complete this request.
	MAX_LIMIT_EXCEED_INTERNAL	Please contact Coda Payments for more information
	INVALID_NAME	Invalid Name, symbols are not allowed. Please re-submit using a valid name. Example: 𝒁𝒂𝒉𝒊𝒅𝒂 𝒑𝒂𝒓𝒗𝒆𝒆𝒏: ❌ 𝑩𝒆𝒓𝒍𝒍𝒂ꨄ︎: Rejected: ❌ 𝘼𝙧𝙞𝙖𝙬𝙖𝙣 𝙁𝙪𝙖𝙙: ❌ Kevin Lehner: ✅ محمد يتيم وتيد العنزي: ✅ Vasantha janga: ✅

Coda Status	Coda Error Code	Coda Error Description
FAILED	BENEFICIARY_REJECTED	Beneficiary rejected the payout. Please re-submit your payout request if this was a mistake.
	EXTERNAL_ERROR	Please contact Coda Payments support team.
	INCOMPLETE_DATA	Incomplete Payment Details. Please check that you have input all relevant details and try again.
	INTERNAL_ERROR	Please contact Coda Payments support team.
	INVALID_ACCOUNT	Account is Closed, Frozen, or Inactive. Please check with your provider and try again when your account is active.
	INVALID_ACCOUNT_DETAILS	Invalid Account Details. Please check your account details and try again.
	INVALID_ACCOUNT_NUMBER	Invalid Account Number. Please re-submit with a valid account number.
	INVALID_AMOUNT	Invalid amount. Please re-submit with a valid input amount.
	INVALID_BANK_CODE	Invalid Bank Code. Please re-submit with a valid bank code.
	INVALID_CURRENCY	Invalid Currency. Please check that both the sending and receiving currency are supported and valid.
	INVALID_DATA	Invalid Payment Details. Please check that you have input all details correctly and try again.
	INVALID_DATE	Invalid Date. Please check the date format or the validity of the date.
	INVALID_ID	Invalid National ID. Please retry using a valid National ID.
	INVALID_NAME	Invalid Name, symbols are not allowed. Please re-submit using a valid name.
	INVALID_PHONE	Invalid phone number. Please retry using a valid phone number.
	MAX_ACCOUNT_LIMIT_EXCEED	Exceeded maximum payout amount for your account. Please check your account limits before trying again.
	MAX_COUNT_EXCEED	Exceeded transaction count limit. Please check your count limit and try again later.
	MAX_LIMIT_EXCEED	Exceeded maximum amount. Please change the input amount and try again.
	NOT_VODAFONE_CASH	MSISDN is not registered as Vodafone Cash. Please provide the correct mobile operator. (Note: This only applies for Egypt payout)
	SUCCESS_TO_FAILED	Payout status was Success but eventually changed to Failed as it was rejected by beneficiary bank. Please re-submit your payout request with the correct details. (Note: This change from one final state to another only applies for Saudi Arabia bank transfer payout)