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
requireAuthestablecido entrue. - 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 (
internalIdoexternalId) 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
- Transacción única (ID externo)
- Transacción única (ID interno)
- Autorización masiva (rango de fechas)
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
Flujo de trabajo recomendado
- Crear Payout: Genera el payout con
requireAuth=true - Verificar el estado: Confirma que el estado de la transacción es
PendingAuth - Detalles de la revisión: Validar la información de la transacción
- Autorizar: Llamar al endpoint de autorización
- Manejo de respuestas: Procesar las respuestas de éxito/error de forma adecuada.
- 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.

