Antes de comenzar
- Credenciales de API válidas (token de acceso) para Stage.
- Familiaridad con Enviar fondos mediante transferencia bancaria y con la estructura de la solicitud Create a Payout.
- 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 enIn 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.
- Tú envías un payout en Stage usando una de las cuentas de prueba de las tablas siguientes.
- Localpayment valida la estructura de la solicitud y, si es válida, establece el payout en
In Progressmientras lo enruta para una respuesta bancaria simulada. - 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.
- 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
REJECTEDsin esperar un rechazo bancario real.
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 payoutREJECTED con el status.code y el status.description correspondientes.
Cuentas de prueba por país
Cada pestaña enumera los datos bancarios del beneficiario de un país. Todos los escenarios comparten el mismopaymentMethod.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.
- Argentina
- Bolivia
- Brasil
- Chile
- Colombia
- Costa Rica
- República Dominicana
- El Salvador
- Guatemala
- Honduras
- México
- Panamá
- Paraguay
- Perú
Método de pago: COELSA, código
0010 · Banco: BANCO DE GALICIA (007) · account.type: S · account.details es el CBUaccount.type C (cuenta corriente) también funciona para estos escenarios.Referencia de mapeo de campos
Las cuentas de prueba anteriores completan el objeto estándarbeneficiary.bank de Create a Payout:
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
Enviar fondos mediante transferencia bancaria
Referencia completa de la API para crear payouts mediante transferencia bancaria, incluidos los requisitos específicos de cada país.
Devoluciones y retiros del mercado
Comprende qué ocurre cuando un payout es rechazado o devuelto después de completarse en Producción.

