Saltar al contenido principal
Envía fondos a través de la billetera utilizando la API de Localpayment. Esta guía abarca todo lo que necesitas saber sobre cómo crear pagos, gestionar las respuestas, administrar el estado de las transacciones y cumplir con los requisitos específicos de cada país. Los payouts a billetera te permiten enviar fondos directamente a la billetera digital del beneficiario. Puedes iniciar estas transferencias a través de cualquiera de las siguientes opciones:
  • Portal comercial de Localpayment: Interfaz fácil de usar para la gestión manual de transacciones.
  • Integración de API: Acceso programático para el procesamiento automatizado de pagos.
Esta guía se centra en la implementación de la API, abarcando el flujo completo desde la inicialización hasta la finalización.

Antes de comenzar

Asegúrate de tener:

Paso 1: Inicializar la transacción de pago

Para crear un payout a billetera, envía una solicitud POST al endpoint Create a Payout con paymentMethod.type establecido en Wallet.

Endpoint

Encabezados obligatorios

Parámetros clave de la solicitud

La solicitud requiere varios objetos clave:

Ejemplo de solicitud (Bolivia)

curl

Paso 2: Gestionar la respuesta

Respuesta exitosa

Una respuesta exitosa incluye información detallada de la transacción e identificadores de seguimiento:

Campos de respuesta clave

Respuesta de error

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

Paso 3: Seguimiento del estado de la transacción

Después de realizar un pago, 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

Referencia completaConsulta todos los códigos de estado en nuestra documentación sobre el estado de las transacciones.

Paso 4: Aprobación de la transacción

Para mayor seguridad, ciertas transacciones requieren la aprobación de dos personas:
  1. Iniciador: Envía la solicitud de pago.
  2. Aprobador: Revisa y confirma la transacción.
Este proceso se puede gestionar a través del Business Portal o de los endpoints de la API.
Nota de seguridadLos requisitos de aprobación ayudan a prevenir transacciones no autorizadas y a garantizar el cumplimiento de las normativas locales.

Requisitos específicos de cada país

Los detalles de implementación varían según el país. Cualquier país no mencionado explícitamente se rige por el procedimiento estándar sin requisitos especiales. Revisa estos requisitos antes de la integración:
Pagos con YAPE:
  • paymentMethod.code: Establece el valor 0021.
  • beneficiary.bank.code: Establece el valor 990.
  • beneficiary.bank.account.alias: Debe contener el número de teléfono del beneficiario en el formato +591XXXXXXXX (formato internacional completo).
  • Omite los siguientes campos: beneficiary.bank.account.type y beneficiary.bank.account.number.


Probando tu integración

Entorno de pruebas

Utiliza el entorno de prueba para realizar las pruebas:

Escenarios de prueba

Verifica que tu integración gestione estos escenarios:
  1. Transacción exitosa: Flujo de pago estándar
  2. Errores de validación: Cuenta bancaria no válida, campos faltantes
  3. Retrasos en el procesamiento: Transacciones que requieren tiempo para procesarse.
  4. Transacciones fallidas: Fondos insuficientes, beneficiarios bloqueados
  5. Actualizaciones de estado: Gestión de webhooks y sondeo de estado

Recursos y próximos pasos

Maximiza el éxito de tu integración con estos recursos esenciales.

Integración de webhooks

Configura notificaciones en tiempo real para las actualizaciones del estado de las transacciones.

Portal de informes empresariales

Accede a análisis detallados, herramientas de generación de informes y funciones de conciliación.

Monitoreo de transacciones

Aprende a consultar el estado de las transacciones e implementar un seguimiento exhaustivo.

Referencia de la API

Documentación completa del endpoint con ejemplos interactivos.

Consejo profesionalSiempre prueba tu flujo de trabajo en nuestro entorno de pruebas antes de implementarlo en producción. Esto garantiza que el manejo de errores, el procesamiento de webhooks y el seguimiento del estado funcionen correctamente en todos los escenarios.

¿Necesitas ayuda?Ponte en contacto con nuestro equipo de soporte si experimentas algún problema o necesitas ayuda con la integración.

Última modificación el 10 de noviembre de 2026