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

# Pruebas en entorno aislado para pagos

Usa las cuentas de prueba de Stage para activar escenarios específicos de rechazo de payouts antes de salir a producción con payouts mediante transferencia bancaria.

Antes de enviar payouts a beneficiarios reales en Producción, usa el entorno Stage para confirmar que tu integración maneja tanto los payouts exitosos como los escenarios de rechazo que los bancos de los beneficiarios devuelven en la práctica. Esta guía cubre el flujo de sandbox de payouts mediante transferencia bancaria y proporciona cuentas de prueba dedicadas, una por país, que activan de forma determinista cada escenario de rechazo.

## Antes de comenzar

* [Credenciales de API](https://docs.localpayment.com/es/docs/api-keys-and-environments.md) válidas (token de acceso) para Stage.
* Familiaridad con [Enviar fondos mediante transferencia bancaria](https://docs.localpayment.com/es/docs/send-funds-via-bank-transfer.md) y con la estructura de la solicitud [Create a Payout](https://docs.localpayment.com/es/reference/create-a-payout.md).
* Un endpoint del webhook configurado para recibir notificaciones de estado de los payouts.

***

## Cómo simula los rechazos el entorno aislado

Stage no mueve dinero real, pero sigue el mismo flujo que Producción: Localpayment recibe tu solicitud, valida la estructura de la solicitud y, si tiene el formato correcto, la establece en `In Progress` y la enruta para una respuesta bancaria simulada según los detalles de la cuenta que tú envíes. Esa respuesta decide si el payout se aprueba o se rechaza. Tú conoces el resultado de la forma habitual: por webhook o consultando el estado de la transacción.

Cualquier payout con una solicitud correctamente estructurada se aprueba automáticamente. Las cuentas de prueba de esta guía son la excepción: cada una está asignada a un motivo de rechazo específico, de modo que puedas reproducir esa condición de error a demanda en lugar de esperar a que ocurra de forma natural.

```mermaid theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#31467c', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#0c1a29', 'actorBkg': '#31467c', 'actorBorder': '#0c1a29', 'actorTextColor': '#ffffff', 'actorLineColor': '#0c1a29', 'signalColor': '#0c1a29', 'signalTextColor': '#0c1a29', 'labelBoxBkgColor': '#31467c', 'labelBoxBorderColor': '#0c1a29', 'labelTextColor': '#ffffff', 'loopTextColor': '#0c1a29', 'noteBkgColor': '#ffffff', 'noteBorderColor': '#31467c', 'noteTextColor': '#0c1a29'}}}%%
sequenceDiagram
  autonumber
  participant Dev as Su backend
  participant LP as Localpayment (Stage)
  participant Bank as Respuesta simulada del banco

  Dev->>LP: POST /api/payout/ (datos de prueba de beneficiary.bank)
  LP->>LP: Validar los campos de la solicitud
  LP-->>Dev: Respuesta: estado In Progress
  LP->>Bank: Enrutar el payout
  Bank-->>LP: Aprobar, o rechazar con el código de prueba asignado
  alt Rechazado
    LP-->>Dev: Webhook: estado REJECTED (código / descripción)
  else Aprobado
    LP-->>Dev: Webhook: estado COMPLETED
  end
  Dev->>LP: (o) GET del estado del payout
  LP-->>Dev: Estado actual
```

1. Tú envías un payout en Stage usando una de las cuentas de prueba de las tablas siguientes.
2. Localpayment valida la estructura de la solicitud y, si es válida, establece el payout en `In Progress` mientras lo enruta para una respuesta bancaria simulada.
3. La respuesta bancaria simulada evalúa los detalles de la cuenta del beneficiario. Una cuenta con estructura correcta que no coincide con ninguna de las cuentas de prueba siguientes se aprueba automáticamente. Una cuenta de prueba se rechaza con su código asignado.
4. Localpayment te notifica el estado final a través del endpoint de tu webhook, o tú lo obtienes consultando la transacción. Usa esto para confirmar que tu integración reacciona correctamente a los payouts `REJECTED` sin esperar un rechazo bancario real.

> [!NOTE]
>
> Estas cuentas de prueba son solo para Stage. Enviar un payout a una de estas cuentas en Producción no producirá el mismo resultado, ya que Producción enruta a bancos reales.

***

## Códigos de rechazo

Cada cuenta de prueba siguiente devuelve uno de estos cinco resultados. Todos se resuelven en un payout `REJECTED` con el `status.code` y el `status.description` correspondientes.

| Código | Descripción | Escenario |
| - | - | - |
| `701` | `InvalidAccountNumber` | El número de cuenta no supera la validación de formato o de dígito verificador. |
| `702` | InvalidAccountNumber - Account Closed | La cuenta existe en cuanto al formato, pero está cerrada o inactiva. |
| `703` | InvalidAccountNumber - Account Blocked | La cuenta existe en cuanto al formato, pero está bloqueada. |
| `640` | Transaction rejected by AML | La transacción es rechazada por los controles AML. |
| `833` | Error account does not accept transfers | La cuenta o institución de destino no acepta transferencias entrantes. |

***

## Cuentas de prueba por país

Cada pestaña enumera los datos bancarios del beneficiario de un país. Todos los escenarios comparten el mismo `paymentMethod.code` y, salvo que se indique lo contrario, el mismo `beneficiary.bank.code` y `beneficiary.bank.name` de ese país. `account.details` es el valor que debes enviar en `beneficiary.bank.account.number` (o en `beneficiary.bank.account.alias`, cuando se indique) para activar el código de rechazo correspondiente. `Description` es el `status.description` que verás en la respuesta y en el webhook para ese código.

> [tab] Argentina
>
> **Método de pago:** COELSA, código `0010` · **Banco:** BANCO DE GALICIA (`007`) · `account.type`: `S` · `account.details` es el CBU
>
> | Código | `account.details` | Descripción |
> | - | - | - |
> | `701` | `0070001600000000000017` | `InvalidAccountNumber` |
> | `702` | `0070001600000000000024` | InvalidAccountNumber - Account Closed |
> | `703` | `0070001600000000000031` | InvalidAccountNumber - Account Blocked |
> | `640` | `0070001600000000000048` | Transaction rejected by AML |
> | `833` | `0070001600000000000055` | Error account does not accept transfers |
>
> `account.type` `C` (cuenta corriente) también funciona para estos escenarios.

> [tab] Bolivia
>
> **Método de pago:** código `0020` · Cualquier institución · `account.type`: `S` · `beneficiary.bank.code` aún no está publicado; confirma el valor correcto con tu gerente de cuenta antes de salir a producción.
>
> | Código | `account.details` | Descripción |
> | - | - | - |
> | `701` | `00000001` | `InvalidAccountNumber` |
> | `702` | `00000002` | InvalidAccountNumber - Account Closed |
> | `703` | `00000003` | InvalidAccountNumber - Account Blocked |
> | `640` | `00000004` | Transaction rejected by AML |
> | `833` | `00000005` | Error account does not accept transfers |

> [tab] Brasil
>
> **Método de pago:** PIX, código `0031`
>
> Los payouts PIX identifican al beneficiario mediante `beneficiary.bank.account.alias` (la clave PIX) en lugar de un número de cuenta bancaria. Algunos de los escenarios siguientes usan en su lugar una cuenta bancaria estándar, para cubrir también a los beneficiarios de transferencia bancaria.
>
> | Código | `account.details` | Descripción |
> | - | - | - |
> | `701` | `account.alias`: `00100000001` | `InvalidAccountNumber` |
> | `702` | Banco `001` BCO DO BRASIL S.A. · `account.number`: `00001235-0` | InvalidAccountNumber - Account Closed |
> | `703` | Banco `001` BCO DO BRASIL S.A. · `account.number`: `00001234-1`, `account.type`: `S` | InvalidAccountNumber - Account Blocked |
> | `640` | `account.alias`: `rejected.aml@sandbox.br` | Transaction rejected by AML |
> | `833` | `account.alias`: `00100000005` | Error account does not accept transfers |

> [tab] Chile
>
> **Método de pago:** código `0050` · **Banco:** BANCO DE CHILE (`001`) · `account.type`: `S`
>
> | Código | `account.details` | Descripción |
> | - | - | - |
> | `701` | `001000000001` | `InvalidAccountNumber` |
> | `702` | `001000000002` | InvalidAccountNumber - Account Closed |
> | `703` | `001000000003` | InvalidAccountNumber - Account Blocked |
> | `640` | `001000000004` | Transaction rejected by AML |
> | `833` | `001000000005` | Error account does not accept transfers |
>
> `account.type` acepta `S` (ahorros), `C` (cuenta corriente) o `V` (vista).

> [tab] Colombia
>
> Estos escenarios de prueba usan el riel ACH (código `0060`). Cualquier institución acepta estos valores de prueba. `account.type`: `S`.
>
> | Código | `account.details` | Descripción |
> | - | - | - |
> | `701` | `000000001` | `InvalidAccountNumber` |
> | `702` | `000000002` | InvalidAccountNumber - Account Closed |
> | `703` | `000000003` | InvalidAccountNumber - Account Blocked |
> | `640` | `000000004` | Transaction rejected by AML |
>
> Este escenario usa Bre-B (código `0062`) en su lugar. `account.type`: `P`.
>
> | Código | `account.details` | Descripción |
> | - | - | - |
> | `833` | `+573000000005` | Error account does not accept transfers |

> [tab] Costa Rica
>
> **Método de pago:** código `0070` · **Banco:** BANCO DE COSTA RICA (`0152`) · `account.type`: `S` · `account.details` es el IBAN (22 caracteres)
>
> | Código | `account.details` | Descripción |
> | - | - | - |
> | `701` | `CR38015200000000000001` | `InvalidAccountNumber` |
> | `702` | `CR11015200000000000002` | InvalidAccountNumber - Account Closed |
> | `703` | `CR81015200000000000003` | InvalidAccountNumber - Account Blocked |
> | `640` | `CR54015200000000000004` | Transaction rejected by AML |
> | `833` | `CR27015200000000000005` | Error account does not accept transfers |

> [tab] República Dominicana
>
> **Método de pago:** código `0080` · **Banco:** BANCO BHD (`101012308`) · `account.details` es el IBAN (28 caracteres)
>
> | Código | `account.details` | Descripción |
> | - | - | - |
> | `701` | `DO13BAGR00000000000000000001` | `InvalidAccountNumber` |
> | `702` | `DO83BAGR00000000000000000002` | InvalidAccountNumber - Account Closed |
> | `703` | `DO56BAGR00000000000000000003` | InvalidAccountNumber - Account Blocked |
> | `640` | `DO29BAGR00000000000000000004` | Transaction rejected by AML |
> | `833` | `DO02BAGR00000000000000000005` | Error account does not accept transfers |

> [tab] El Salvador
>
> **Método de pago:** código `0100` · Cualquier institución · `account.type`: `S` · `account.details` es el IBAN (28 caracteres)
>
> | Código | `account.details` | Descripción |
> | - | - | - |
> | `701` | `SV50ACAT00000000000000000001` | `InvalidAccountNumber` |
> | `702` | `SV23ACAT00000000000000000002` | InvalidAccountNumber - Account Closed |
> | `703` | `SV93ACAT00000000000000000003` | InvalidAccountNumber - Account Blocked |
> | `640` | `SV66ACAT00000000000000000004` | Transaction rejected by AML |
> | `833` | `SV39ACAT00000000000000000005` | Error account does not accept transfers |

> [tab] Guatemala
>
> **Método de pago:** código `0110` · Cualquier institución · `account.type`: `S` · `beneficiary.bank.code` aún no está publicado; confirma el valor correcto con tu gerente de cuenta antes de salir a producción.
>
> | Código | `account.details` | Descripción |
> | - | - | - |
> | `701` | `0000000001` | `InvalidAccountNumber` |
> | `702` | `0000000002` | InvalidAccountNumber - Account Closed |
> | `703` | `0000000003` | InvalidAccountNumber - Account Blocked |
> | `640` | `0000000004` | Transaction rejected by AML |
> | `833` | `0000000005` | Error account does not accept transfers |

> [tab] Honduras
>
> **Método de pago:** código `0120` · Cualquier institución · `account.type`: `S` · `beneficiary.bank.code` aún no está publicado; confirma el valor correcto con tu gerente de cuenta antes de salir a producción.
>
> | Código | `account.details` | Descripción |
> | - | - | - |
> | `701` | `00000000001` | `InvalidAccountNumber` |
> | `702` | `00000000002` | InvalidAccountNumber - Account Closed |
> | `703` | `00000000003` | InvalidAccountNumber - Account Blocked |
> | `640` | `00000000004` | Transaction rejected by AML |
> | `833` | `00000000005` | Error account does not accept transfers |

> [tab] México
>
> **Método de pago:** SPEI, código `0130` · **Banco:** BANAMEX (`002`) · `account.details` es la CLABE (18 dígitos)
>
> | Código | `account.details` | Descripción |
> | - | - | - |
> | `701` | `002180000000000012` | `InvalidAccountNumber` |
> | `702` | `002180000000000025` | InvalidAccountNumber - Account Closed |
> | `703` | `002180000000000030` | InvalidAccountNumber - Account Blocked |
> | `640` | `002180000000000041` | Transaction rejected by AML |
> | `833` | `002180000000000054` | Error account does not accept transfers |

> [tab] Panamá
>
> **Método de pago:** código `0150` · Cualquier institución · `account.type`: `S` · `beneficiary.bank.code` aún no está publicado; confirma el valor correcto con tu gerente de cuenta antes de salir a producción.
>
> | Código | `account.details` | Descripción |
> | - | - | - |
> | `701` | `000000000001` | `InvalidAccountNumber` |
> | `702` | `000000000002` | InvalidAccountNumber - Account Closed |
> | `703` | `000000000003` | InvalidAccountNumber - Account Blocked |
> | `640` | `000000000004` | Transaction rejected by AML |
> | `833` | `000000000005` | Error account does not accept transfers |

> [tab] Paraguay
>
> **Método de pago:** código `0160` · Cualquier institución · `account.type`: `S` · `beneficiary.bank.code` aún no está publicado; confirma el valor correcto con tu gerente de cuenta antes de salir a producción.
>
> | Código | `account.details` | Descripción |
> | - | - | - |
> | `701` | `000000000001` | `InvalidAccountNumber` |
> | `702` | `000000000002` | InvalidAccountNumber - Account Closed |
> | `703` | `000000000003` | InvalidAccountNumber - Account Blocked |
> | `640` | `000000000004` | Transaction rejected by AML |
> | `833` | `000000000005` | Error account does not accept transfers |

> [tab] Perú
>
> **Método de pago:** código `0170` · **Banco:** Interbank (`003`) · `account.type`: `S` · `account.details` es el CCI (20 dígitos)
>
> | Código | `account.details` | Descripción |
> | - | - | - |
> | `701` | `00300029183746555075` | `InvalidAccountNumber` |
> | `702` | `00300047392810555078` | InvalidAccountNumber - Account Closed |
> | `703` | `00300091827364777776` | InvalidAccountNumber - Account Blocked |
> | `640` | `00300053748291777777` | Transaction rejected by AML |
> | `833` | `00300062839471777776` | Error account does not accept transfers |

***

## Referencia de mapeo de campos

Las cuentas de prueba anteriores completan el objeto estándar `beneficiary.bank` de [Create a Payout](https://docs.localpayment.com/es/reference/create-a-payout.md):

| Campo | Notas |
| - | - |
| `beneficiary.bank.code` | Requerido para Argentina, Chile, Colombia (ACH) y Perú. No es requerido para México (la CLABE ya codifica el banco) ni para PIX de Brasil. |
| `beneficiary.bank.account.number` | Requerido para la mayoría de los países. Exclúyelo cuando envíes en su lugar una clave PIX (Brasil), Perú (Yape), Bolivia (Yape) o Colombia (Bre-B) en `account.alias`. |
| `beneficiary.bank.account.type` | `S` (ahorros), `C` (cuenta corriente) o `V` (vista, solo Chile). Requerido para Argentina, Chile, Colombia y Perú. No se usa con una clave PIX (Brasil), Perú (Yape), Bolivia (Yape) o Colombia (Bre-B). |
| `beneficiary.bank.account.alias` | Se usa para una clave PIX (Brasil), Perú (Yape), Bolivia (Yape) y Colombia (Bre-B). |

Los números de cuenta que superan la validación de dígito verificador (CLABE de México, CBU de Argentina y los formatos IBAN usados por Costa Rica, República Dominicana y El Salvador) son valores de prueba estructuralmente válidos, no cuentas reales. Existen solo para alcanzar el escenario de rechazo asignado.

***

## Próximos pasos

> [card] [Enviar fondos mediante transferencia bancaria](https://docs.localpayment.com/es/docs/send-funds-via-bank-transfer.md)
>
> Referencia completa de la API para crear payouts mediante transferencia bancaria, incluidos los requisitos específicos de cada país.

> [card] [Devoluciones y retiros del mercado](https://docs.localpayment.com/es/docs/returns-and-recalls.md)
>
> Comprende qué ocurre cuando un payout es rechazado o devuelto después de completarse en Producción.


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