Mono Colombia
BankingSandbox

Transferencias bancarias

Prueba transferencias bancarias en el entorno de sandbox con escenarios simulados para ACH, Turbo, Transfiya y transferencias Bre-B.

En el entorno de sandbox puedes simular transferencias bancarias exitosas y rechazadas. Para desarrollar tu sistema correctamente, ten en cuenta que dos validaciones ocurren antes de que el dinero se acredite en la cuenta del beneficiario.

  1. Para simular casos ACH o Turbo, configura el valor correspondiente en el campo routing.
  2. La simulación evalúa el campo payee.document_number.

ACH

Estos casos están disponibles para simular para ACH:

Validaciones del banco de origen

La primera validación la hace nuestro banco aliado para asegurar que tienes saldo suficiente, incluyendo el GMF, y que no has excedido los límites transaccionales de la cuenta de origen (cualquier usuario admin puede ajustar estos límites directamente en la interfaz de usuario). Las declinaciones del banco de origen en producción usualmente se informan en menos de 10 minutos a través de un webhook.

Caso de prueba: payee.document_number empieza con 888 y termina con 000 (por ejemplo, 88814235000)

Validaciones del banco destino

La segunda validación la hace el banco destino para revisar la información y el estado de la cuenta. En producción, estas declinaciones toman hasta tres ciclos ACH, o alrededor de 12 horas hábiles, para ser recibidas. En el sandbox se simulan en 2 minutos.

Caso de prueba: payee.document_number empieza con 999 y termina con 000 (por ejemplo, 99914235000)

Transferencia bancaria ACH exitosa

La transferencia debe ser aprobada.

Caso de prueba: payee.document_number no cumple el criterio de ninguno de los otros casos de prueba.


Turbo

Estos casos están disponibles para simular para Turbo:

EscenarioDescripciónCaso de prueba
Límite global excedidoLa transferencia excede el límite global permitido para la cuenta.Empieza con 777, termina con 000
Fondos insuficientesLa cuenta origen no tiene fondos suficientes para completar la transferencia.Empieza con 777, termina con 111 o empieza con 111, termina con 000
Turbo no soportadoEl banco destino no soporta transferencias Turbo (signer no encontrado).Empieza con 777, termina con 222
Deadline de transacción excedidoLa transferencia fue rechazada por el banco destino por timeout.Empieza con 777, termina con 333 o empieza con 100, termina con 001
Cuenta deshabilitadaLa cuenta destino está deshabilitada.Empieza con 777, termina con 444
Transferencia Turbo exitosaLa transferencia debe ser aprobada.No cumple ningún otro criterio

Transfiya

Estos casos están disponibles para simular para Transfiya:

EscenarioDescripciónCaso de prueba
Límite global excedidoLa transferencia excede el límite global permitido para la cuenta.Empieza con 555, termina con 000
Cuenta deshabilitadaLa cuenta destino está deshabilitada.Empieza con 555, termina con 444
Fondos insuficientesLa cuenta origen no tiene fondos suficientes para completar la transferencia.Empieza con 555, termina con 111
Deadline de transacción excedidoLa transferencia fue rechazada por el banco destino por timeout.Empieza con 555, termina con 222
Transacción no completadaEl usuario rechazó o no completó la transacción a través de Transfiya.Empieza con 555, termina con 333
Transferencia Transfiya exitosaLa transferencia debe ser aprobada.No cumple ningún otro criterio

"global_limit_exceeded" es el único caso que permite simulación de routing con un error permitido para fallbacks.


CoopCentral Bre-B

CoopCentral Bre-B provee transferencias instantáneas a través de la red Bre-B. El sandbox te permite simular distintos escenarios usando patrones específicos en la llave Bre-B (para búsquedas de llave) y el campo descripción (para operaciones de transacción).

Proceso de transferencia Bre-B

Una transferencia Bre-B sigue un proceso de tres pasos:

  1. Búsqueda de llave: primero, el sistema valida la llave Bre-B y recupera la información de cuenta asociada desde la red.
  2. Inicio de transacción: una vez validada la llave, la transferencia se inicia con el participante destino.
  3. Verificación de estado: finalmente, se chequea el estado de la transacción para confirmar si se completó exitosamente o falló.

Las secciones de simulación de abajo corresponden a cada uno de estos pasos, permitiéndote probar distintos escenarios en cada etapa del proceso de transferencia.

Validación de identidad

Para transferencias Bre-B exitosas en sandbox, cuando envíes información del documento de identidad, debes usar:

  • document_type: CC
  • document_number: 12345678

Importante: si envías información de identidad del documento y difiere de estos valores, la transferencia generará errores. También puedes elegir no enviar la información de identidad del documento para saltarte esta validación.

Simulación de búsqueda de llave Bre-B

Estos casos están disponibles para simular la búsqueda de llave Bre-B usando patrones de llave Bre-B específicos:

EscenarioDescripciónCaso de prueba
Llave no encontradaLa llave Bre-B no existe en la red.La llave contiene key_not_found
Participante no disponibleEl participante/banco destino está temporalmente no disponible.La llave empieza con key_unavailable
Llave bloqueada o inactivaLa llave Bre-B está bloqueada o inactiva en la red.La llave contiene key_blocked
TimeoutLa solicitud de búsqueda de llave tuvo timeout.La llave contiene key_timeout
Búsqueda exitosaLa búsqueda de llave Bre-B debe ser exitosa y devolver información de cuenta.La llave no coincide con ningún patrón de error

Simulación de inicio de transacción Bre-B

Estos casos están disponibles para simular el inicio de transacción Bre-B usando patrones de descripción específicos:

EscenarioDescripciónCaso de prueba
TimeoutLa solicitud de inicio de transacción tuvo timeout.La descripción contiene tx_timeout
Cuenta deshabilitadaLa cuenta destino está deshabilitada.La descripción contiene tx_disabled
Llave Bre-B inválidaLa llave Bre-B provista es inválida.La descripción contiene tx_invalid_key
Límite de monto diario excedidoLa transferencia excede el límite de monto diario.La descripción contiene tx_limit_daily_amount
Límite de conteo diario excedidoLa cuenta excedió el límite diario de conteo de transacciones.La descripción contiene tx_limit_daily_count
Fraude detectadoLa transacción fue marcada como fraudulenta.La descripción contiene tx_fraud
Fondos insuficientesLa cuenta origen no tiene fondos suficientes.La descripción contiene tx_insufficient
Límite de monto mensual excedidoLa transferencia excede el límite de monto mensual.La descripción contiene tx_limit_monthly_amount
Límite de conteo mensual excedidoLa cuenta excedió el límite mensual de conteo de transacciones.La descripción contiene tx_limit_monthly_count
Cuenta inválidaLa información de la cuenta destino es inválida.La descripción contiene tx_invalid_account
Cuenta bloqueadaLa cuenta destino está bloqueada.La descripción contiene tx_blocked
Error desconocidoOcurrió un error desconocido durante el procesamiento.La descripción contiene tx_error
Inicio exitosoLa transacción debe iniciarse exitosamente.La descripción no coincide con ningún patrón de error

Simulación de estado de transacción Bre-B

Estos casos están disponibles para simular chequeos de estado de transacción Bre-B usando patrones de llave Bre-B específicos:

La simulación de estado de transacción usa la misma llave Bre-B que se usó durante el paso de búsqueda de llave. El sistema valida el patrón de la llave Bre-B para determinar qué estado devolver.

EscenarioDescripciónCaso de pruebaCódigo de estado
Transacción no encontradaEl ID de transacción no existe.La llave contiene status_not_found-
TimeoutLa solicitud de chequeo de estado tuvo timeout.La llave contiene status_timeout-
Participante no disponibleEl participante no está disponible para chequeos de estado.La llave contiene status_unavailable-
Transacción fallidaLa transacción falló.La llave contiene status_failed91
Transacción pendienteLa transacción aún está pendiente.La llave contiene status_pending-
Transacción exitosaLa transacción se completó exitosamente.La llave no coincide con ningún patrón de error00

En esta página