Payout Error Response

Error response returned by PaysafeCard payout operations.

Payout error codes

Code	Number	HTTP status	Description
customer_balance_exceeded	3167	400	Customer balance exceeded.
topup_limit_exceeded	3170	400	Add-up limit exceeded.
customer_yearly_payout_limit_reached	3194	400	Customer yearly payout limit exceeded.
customer_details_mismatched	3195	400	Customer details from the request do not match the stored details.
mypsc_account_not_found	3162	400	No customer account was found using the provided credentials.
max_amount_of_payout_merchants_reached	3198	400	The maximum number of payout merchant clients is already assigned to the account.
max_payout_merchant_clients_assigned	3197	400	The maximum number of payout accounts is already assigned to the customer ID.
kyc_invalid_for_payout_customer	3168	400	Payout rejected because account registration is incomplete.
missing_parameter	3150	400	A mandatory parameter is missing.
merchant_not_allowed_for_payout	3161	400	The merchant is not allowed to perform this action.
duplicate_payout_request	3164	400	The transaction already exists.
invalid_amount	3165	400	Invalid payout amount.
merchant_limit_reached	3166	400	The merchant's daily payout limit was reached.
payout_id_collision	3169	400	The payout ID collides with an existing disposition ID.
payout_amount_below_minimum	3171	400	The payout amount is below the merchant's minimum payout amount.
customer_inactive or customer_not_active	3193	400	Customer account is not active.
payout_blocked	3199	400	The payout was blocked for security reasons.

Other errors may be communicated as a general technical error.

codestringrequired

Machine-readable payout error code.

Example: customer_balance_exceeded

messagestringrequired

Human-readable description of the payout error.

Example: Customer balance exceeded.

numberintegerrequired

Numeric payout error identifier.

Example: 3167

paramstringnullable

Request parameter associated with the error, when applicable.

Example: amount

Payout Error Response

{
  "code": "customer_balance_exceeded",
  "message": "Customer balance exceeded.",
  "number": 3167,
  "param": "amount"
}