> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onepay.la/llms.txt
> Use this file to discover all available pages before exploring further.

# Índice de códigos

> Todos los códigos de error de la API ordenados por número, con el módulo donde aparecen.

Si ya tienes un `code` o un `code_name`, búscalo aquí para saber en qué módulo aparece y abrir su tabla con la causa y qué hacer. Los motivos por los que falla un cargo (`101xx` en `remarks`) están aparte, en [Motivos de rechazo de cargos](/client/base/errors/codes).

<Warning>
  Tres códigos numéricos se repiten entre errores distintos: `10003`, `10004` y `15004`. En esos
  casos decide por `code_name`.
</Warning>

## Códigos numéricos

| `code` | `code_name` | HTTP | Dónde aparece |
| - | - | - | - |
| `10001` | `validation_error` | 422 | [Errores comunes](/client/base/errors/common#validación) y todos los módulos |
| `10002` | `record_not_found` | 404 | [Errores comunes](/client/base/errors/common#recurso-no-encontrado) y todos los módulos |
| `10003` | `account_validation_error` | 400 | [Empresas y métodos de pago](/client/base/errors/companies-payment-methods) |
| `10003` | `idempotency_error` | 409 | [Errores comunes](/client/base/errors/common#idempotencia), en todo `POST` |
| `10003` | `public_key_not_supported` | 409 | [Errores comunes](/client/base/errors/common) |
| `10004` | `environment_key_mismatch` | 404 | [Errores comunes](/client/base/errors/common) |
| `10004` | `read_only_key_not_supported` | 403 | [Errores comunes](/client/base/errors/common) · [Billeteras y emisión de tarjetas](/client/base/errors/fintech) |
| `10005` | `api_key_scope_not_allowed` | 403 | [Errores comunes](/client/base/errors/common) |
| `10006` | `api_key_ability_not_supported` | 403 | [Errores comunes](/client/base/errors/common) |
| `10100` | `card_generic` | 422 | [Empresas y métodos de pago](/client/base/errors/companies-payment-methods) |
| `10102` | `card_cvv` | 422 | [Recaudo](/client/base/errors/collections) · [Empresas y métodos de pago](/client/base/errors/companies-payment-methods) |
| `10104` | `card_number` | 422 | [Recaudo](/client/base/errors/collections) · [Empresas y métodos de pago](/client/base/errors/companies-payment-methods) |
| `10122` | `card_expired` | 422 | [Recaudo](/client/base/errors/collections) · [Empresas y métodos de pago](/client/base/errors/companies-payment-methods) |
| `10126` | `customer_data_invalid` | 422 | [Recaudo](/client/base/errors/collections) |
| `10136` | `transaction_otp_invalid` | 422 | [Recaudo](/client/base/errors/collections) |
| `10140` | `request_to_pay_not_available` | 422 | [Recaudo](/client/base/errors/collections) |
| `10141` | `request_to_pay_in_progress` | 422 | [Recaudo](/client/base/errors/collections) |
| `10148` | `transaction_otp_expired` | 422 | [Recaudo](/client/base/errors/collections) |
| `10500` | `balance_is_empty` | 401 | [Balances y dispersiones](/client/base/errors/payouts) · [Billeteras y emisión de tarjetas](/client/base/errors/fintech) |
| `10501` | `insufficient_funds` | 401 | [Balances y dispersiones](/client/base/errors/payouts) · [Billeteras y emisión de tarjetas](/client/base/errors/fintech) |
| `10803` | `company_amount_limit` | 422 | [Servicios públicos](/client/base/errors/utilities) |
| `10805` | `charge_refunded` | 422 | [Recaudo](/client/base/errors/collections) |
| `10806` | `charge_is_test` | 422 | [Recaudo](/client/base/errors/collections) |
| `10807` | `charge_is_not_paid` | 422 | [Recaudo](/client/base/errors/collections) |
| `10808` | `charge_not_cancellable` | 422 | [Recaudo](/client/base/errors/collections) |
| `10809` | `company_account_not_found` | 422 | [Balances y dispersiones](/client/base/errors/payouts) |
| `15001` | `cant_cancel_payment` | 422 | [Recaudo](/client/base/errors/collections) |
| `15002` | `cant_retry_payment` | 422 | [Recaudo](/client/base/errors/collections) |
| `15003` | `payment_already_paid` | 422 | [Recaudo](/client/base/errors/collections) · [Facturación](/client/base/errors/billing) |
| `15004` | `payment_cancelled` | 422 | [Recaudo](/client/base/errors/collections) · [Facturación](/client/base/errors/billing) |
| `15004` | `payment_charge_in_progress` | 422 | [Recaudo](/client/base/errors/collections) · [Facturación](/client/base/errors/billing) |
| `15005` | `pse_payment_duplicate` | 429 | [Recaudo](/client/base/errors/collections) |
| `15007` | `cant_update_payment` | 422 | [Recaudo](/client/base/errors/collections) |
| `18000` | `card_has_benn_cancelled` | 409 | [Billeteras y emisión de tarjetas](/client/base/errors/fintech) |
| `18001` | `card_is_already_active` | 409 | [Billeteras y emisión de tarjetas](/client/base/errors/fintech) |
| `18002` | `card_is_not_physical` | 409 | [Billeteras y emisión de tarjetas](/client/base/errors/fintech) |
| `18003` | `card_is_not_active` | 409 | [Billeteras y emisión de tarjetas](/client/base/errors/fintech) |
| `18004` | `card_is_cant_visualized` | 409 | [Billeteras y emisión de tarjetas](/client/base/errors/fintech) |
| `18005` | `active_cards_limit_reached` | 422 | [Billeteras y emisión de tarjetas](/client/base/errors/fintech) |
| `22000` | `bill_already_paid` | 418 | [Servicios públicos](/client/base/errors/utilities) |
| `22001` | `bill_cannot_be_paid` | 400 | [Servicios públicos](/client/base/errors/utilities) |
| `22002` | `bill_does_not_exist` | 404 | [Servicios públicos](/client/base/errors/utilities) |
| `22003` | `bill_does_not_have_debt` | 400 | [Servicios públicos](/client/base/errors/utilities) |
| `22004` | `bill_does_not_have_provider` | 404 | [Servicios públicos](/client/base/errors/utilities) |
| `22005` | `bill_expired` | 400 | [Servicios públicos](/client/base/errors/utilities) |
| `22006` | `bill_in_progress` | 400 | [Servicios públicos](/client/base/errors/utilities) |
| `22010` | `not_founds` | 404 | [Servicios públicos](/client/base/errors/utilities) |
| `22012` | `bill_try_latter` | 400 | [Servicios públicos](/client/base/errors/utilities) |
| `22013` | `bill_unknown_error` | 400 | [Servicios públicos](/client/base/errors/utilities) |
| `28006` | `flow_not_found` | 404 | [Webhooks y flows](/client/base/errors/webhooks-flows) |
| `28008` | `flow_recent_send` | 419 | [Webhooks y flows](/client/base/errors/webhooks-flows) |
| `41002` | `cant_be_cancelled` | 422 | [Balances y dispersiones](/client/base/errors/payouts) |
| `41003` | `total_amount_exceeds_the_balance` | 422 | [Balances y dispersiones](/client/base/errors/payouts) |
| `41006` | `customer_account_uncompleted` | 400 | [Balances y dispersiones](/client/base/errors/payouts) |
| `41007` | `customer_onepay_balance_destination` | 400 | [Balances y dispersiones](/client/base/errors/payouts) |
| `41009` | `cant_be_refund` | 422 | [Balances y dispersiones](/client/base/errors/payouts) |
| `41010` | `customer_is_restricted` | 422 | [Balances y dispersiones](/client/base/errors/payouts) |
| `41013` | `daily_cashout_scheduled` | 422 | [Balances y dispersiones](/client/base/errors/payouts) |
| `41015` | `duplicate_external_id` | 422 | [Balances y dispersiones](/client/base/errors/payouts) |
| `90005` | `charge_persistence_lost` | 503 | [Recaudo](/client/base/errors/collections) |
| `90006` | `breb_directory_unavailable` | 503 | [Empresas y métodos de pago](/client/base/errors/companies-payment-methods) |
| `90100` | `qr_generation_failed` | 400 | [Recaudo](/client/base/errors/collections) |
| `220016` | `bill_amount_is_high` | 400 | [Servicios públicos](/client/base/errors/utilities) |

## Códigos de facturación electrónica

Estos errores traen `code` como texto y no tienen `code_name`. Mira [Facturación](/client/base/errors/billing).

| `code` | HTTP | Dónde aparece |
| - | - | - |
| `credit_note_not_issuable` | 422 | [Facturación](/client/base/errors/billing) |
| `customer_not_invoiceable` | 422 | [Facturación](/client/base/errors/billing) |
| `invalid_invoice_line` | 422 | [Facturación](/client/base/errors/billing) |
| `invoice_not_stampable` | 422 | [Facturación](/client/base/errors/billing) |
| `resolution_not_activatable` | 422 | [Facturación](/client/base/errors/billing) |

## Errores sin código

Algunos errores solo traen `message`: estado de la empresa (`403`), filtros u orden inválidos y `per_page` fuera de rango (`400`), límite de peticiones (`429`), errores inesperados (`500`) y los propios de la [sesión de cliente](/client/base/errors/collections#sesión-de-cliente). Cada tabla los marca como «Sin código».


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.