Saltar al contenido principal
Localpayment te permite retirar fondos de tu cuenta de Localpayment y depositarlos en tu propia cuenta bancaria externa mediante la integración de la API y la interfaz del Business Portal. Esta guía abarca el flujo de trabajo completo de transferencia bancaria para la liquidación de fondos, detallando el proceso de autorización, la implementación de la API y el seguimiento del estado.
Wire Out vs. PayoutUn Wire Out es una liquidación/retiro: los fondos se transfieren de tu cuenta de Localpayment a tu propia cuenta bancaria externa, nunca a la de un tercero.Un Payout es un desembolso a un destinatario final (normalmente tu cliente). Si necesitas enviar fondos a un tercero, usa el endpoint Crear Payout.

Antes de comenzar

Asegúrate de tener:

Credenciales de API

Credenciales API válidas y token de acceso para la autenticación.

Configuración de la cuenta

Configuración adecuada de la cuenta para el país de destino y verificación de la empresa.

Lista blanca de IP

Incluye en la lista blanca las direcciones IP de tus servidores para el acceso a la API.

Endpoint del webhook

Configura una URL de webhook para recibir notificaciones de pago.

Requisitos adicionales para Wire Outs:

  • Saldo disponible suficiente en tu cuenta de Localpayment. Consúltalo en el Informe de balance o estima los fondos próximos con el Informe de saldo proyectado.
  • Rol de usuario con permisos suficientes para la autorización de Wire Out (consulta la documentación sobre roles y permisos).
  • Datos de la cuenta bancaria externa (código SWIFT, número de cuenta, información del beneficiario).

Guía de implementación

Localpayment ofrece dos métodos para procesar transferencias bancarias: integración mediante API para el procesamiento automatizado y Business Portal para operaciones manuales.

Procesamiento de Wire Out a través de API

Inicia Wire Out de forma programática mediante la API REST para flujos de liquidación automatizados e integración de sistemas.

Procesamiento de transferencias bancarias del Business Portal

Procesa manualmente las instrucciones de Wire Out a través del Business Portal de Localpayment con una interfaz visual y orientación paso a paso.

Paso 1: Procesar Wire Out a través del API

Para iniciar una transacción de Wire Out a través de la API, envía una solicitud POST al endpoint de Wire Out.

Parámetros clave de la solicitud

La solicitud requiere varios parámetros clave:

Ejemplo de solicitud

curl
Consulta todos los parámetros disponibles en la solicitud.

Paso 2: Gestionar la respuesta

Respuesta exitosa

Un Wire Out iniciado con éxito devuelve los detalles de la transacción con el estado inicial:

Campos de respuesta clave

Respuesta de error

Cuando falla una solicitud de Wire Out, recibirás información detallada sobre el error:

Paso 3: Seguimiento del estado de un Wire Out

Tras iniciar un Wire Out, supervisa su progreso mediante estos métodos:

Webhooks (recomendado)

Recibe notificaciones en tiempo real cuando cambie el estado de la transacción. Más eficiente para entornos de producción.

Endpoint de la API de estado

Consulta el estado de las transacciones mediante programación. Útil para sondear o recuperar notificaciones de webhook perdidas.

Vista del Business Portal

Interfaz visual para el seguimiento de transacciones. Ideal para la supervisión manual y el análisis detallado de las transacciones.

Códigos de estado comunes para Wire Outs

Notificaciones de finalizaciónRecibirás notificaciones por correo electrónico cuando las transacciones alcancen los estados Completed o Rejected, independientemente de si se iniciaron a través de la API o del Business Portal. Para las transacciones de Wire Out con criptomonedas (USDC/USDT), la devolución de llamada del webhook Completed también incluye el hash de la transacción de la cadena de bloques (campo hash) para que puedas verificar el pago de forma independiente en un explorador de bloques. Este campo no se aplica al Wire Out fiduciario; consulta Webhooks para ver un ejemplo completo de la carga útil.

Procesamiento de transferencias bancarias del Business Portal

Las transacciones de transferencia bancaria también se pueden procesar a través de la interfaz del portal comercial de Localpayment. Este método proporciona un flujo de trabajo visual para gestionar las transferencias de fondos y es particularmente útil para:
  • Liquidaciones únicas** que no requieren automatización mediante API.
  • Supervisión administrativa** con flujos de trabajo de autorización visual.
  • Transferencias rápidas de fondos sin recursos para el desarrollo.
Para obtener instrucciones detalladas sobre cómo procesar transacciones de transferencia bancaria a través del Business Portal, incluyendo guías paso a paso y tutoriales de la interfaz, consulta la Guía de Transferencia Bancaria del Business Portal.

Probando tu integración

Escenarios de prueba

Verifica que tu integración gestione estos escenarios:
  1. Wire Out exitosa: Procesar la transferencia con parámetros válidos y saldo suficiente.
  2. Fondos insuficientes: Se intentó realizar una transferencia que excedía el saldo de la cuenta.
  3. Datos bancarios no válidos: Prueba con códigos SWIFT o números de cuenta incorrectos.
  4. Flujo de trabajo de autorización: Verificar el estado de la autorización pendiente y el proceso de aprobación.

Próximos pasos

Ver estado de la transacción

Verifica el estado actual de las transacciones de transferencia bancaria utilizando la API de estado de transacciones.

Configurar webhooks

Configura webhooks para recibir notificaciones en tiempo real sobre los cambios de estado de Wire Out.
Última modificación el 10 de noviembre de 2026