Saltar al contenido principal
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


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.
  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.
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.

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.
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ándar beneficiary.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.
Última modificación el 10 de noviembre de 2026