Payout errors

The error codes the Payouts API returns and what to do about each one.

Errors return { "code", "message" }, plus issues: [{ field, message }] for validation errors. Branch on code.

HTTPcodeWhat to do
400params_validation, invalid_paramsFix the request; issues names the field.
400missing_idempotency_keySend an Idempotency-Key.
400unsupported_assetUse USDC on a chain from GET /v1/payout-accounts.
401missing_api_key, invalid_api_keySend a valid, unrevoked wcpo_ key.
403payouts_disabledPayouts are off for your account. Reads keep working.
404not_foundNo payout with this ID on your account.
409idempotency_conflictThis key was used for a different payout.
409payout_not_cancellableThe payout isn't requires_action, so it can't be cancelled. Read it for its current status.
409payout_account_unavailableYour payout account isn't set up yet.
503screening_unavailableRetry with the same Idempotency-Key.
503payout_account_busyRetry with the same Idempotency-Key.
503payouts_unavailablePayouts aren't available. Don't retry.
500internal_errorRetry; for a payout, with the same Idempotency-Key.