Saltar al contenido principal
Algunas transacciones de pago requieren autorización adicional antes de poder procesarse. Esta guía explica cuándo se necesita autorización y cómo aprobar los pagos mediante diferentes métodos.

Cuando se requiere autorización

Se requiere autorización adicional para los pagos generados bajo estas condiciones:
  • Payouts por API: Creados mediante la API con el parámetro requireAuth establecido en true.
  • Payouts del Business Portal: Creados directamente en el Business Portal de Localpayment.

Métodos de autorización

El método para autorizar los pagos depende de cómo se crearon originalmente: Payouts creados en el Business Portal Para los payouts creados en el Business Portal, debe autorizarlos un segundo usuario con permisos de autorización. Pagos generados por API Para los pagos creados a través de la API, utiliza el endpoint Authorize Payout para aprobar las transacciones mediante programación.

Requisitos previos

Antes de autorizar los pagos, asegúrate de tener:
  • Una transacción de payout inicializada con estado PendingAuth
  • Credenciales API válidas con permisos de autorización
  • El identificador de la transacción (internalId o externalId) o un rango de fechas para la autorización masiva

Autorización de pagos mediante API

Endpoint

Autenticación

Incluye tu token de acceso en los encabezados de la solicitud:

Parámetros clave de la solicitud

Puedes autorizar los pagos utilizando uno de estos tres métodos:
Elige un método de autorizaciónUtiliza un ID de transacción específico (internalId o externalId) para transacciones individuales, o un rango de fechas (dateFrom y dateTo) para la autorización masiva.

Ejemplos de solicitudes


Gestión de respuestas

Respuesta de éxito

Cuando la autorización sea exitosa, recibirás:

Campos de respuesta clave

Respuestas de error

Errores de validación

Mejores prácticas

  • Siempre valida los detalles de la transacción antes de autorizarla.
  • Utiliza HTTPS para todas las solicitudes a la API
  • Almacena los tokens de acceso de forma segura.
  • Implementa un manejo de errores y un registro adecuados
  1. Crear Payout: Genera el payout con requireAuth=true
  2. Verificar el estado: Confirma que el estado de la transacción es PendingAuth
  3. Detalles de la revisión: Validar la información de la transacción
  4. Autorizar: Llamar al endpoint de autorización
  5. Manejo de respuestas: Procesar las respuestas de éxito/error de forma adecuada.
  6. Monitorización: Seguimiento de los cambios de estado de las transacciones mediante webhooks.

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