Guía de desarrollo e integración:API de Payment, Settlement y pago de facturas,diseñe juntos conciliación y Webhook
Payment API gestiona el cobro multicanal; las API de liquidación y de pago de facturas corresponden, respectivamente, a la conversión de gran importe y a los desembolsos medio/pequeños. Webhook e informes hacen que los tres flujos sean rastreables y conciliables dentro de los sistemas del comercio.
Iniciar consulta comercial
Confirme permisos, firmas y reglas de conciliación antes de integrar
El sitio público describe las capacidades centrales de integración; la documentación completa de API, el entorno sandbox, la nomenclatura de eventos y los flujos de estado se proporcionan tras la revisión del comercio, dentro del alcance de servicio aprobado.
- Los permisos de API key deben separarse por uso, evitando mezclar permisos de cobro y de pago.
- Se recomienda que Webhook use verificación de firma, manejo de reintentos y diseño idempotente.
- Los sistemas financieros deben conciliar cuatro tipos de datos: transacciones, comisiones, liquidación y pagos.
- Las transacciones de mayor riesgo o los pagos de gran importe pueden entrar en revisión manual.
Tres tipos de API: quién llama, qué eventos, quién concilia
Diseñado para operaciones reales, no solo para un botón de pago.
- Payment API: crear pedidos, obtener direcciones de pago, consultar estado y gestionar eventos de confirmación de pago.
- Settlement API: solicitar cotizaciones de liquidación de gran importe, consultar estado y comisiones de conversión o retención de criptomoneda.
- API de pago de facturas: iniciar pagos, consultar estado y causas de fallo.
- Webhook y Dashboard: recibir eventos para que operaciones y finanzas los vean de forma unificada.
Puntos clave del diseño de integración
Los problemas habituales de los flujos de pago también incluyen conciliación, sincronización de estado, manejo de cadena errónea, fallos de pago y contabilización de comisiones.
- Admita idempotency key para evitar la creación duplicada de pedidos o pagos.
- Se recomienda que Webhook haga verificación de firma y manejo de reintentos.
- Las transacciones de mayor riesgo o gran importe pueden devolver el estado review_required.
- Los informes CSV admiten conciliación financiera y detalle de comisiones.
Entienda primero, luego empiece.
Sobre el alcance, la diferencia entre liquidación y pagos, y la preparación antes de integrar.
¿A qué comercios les conviene la API?
A plataformas, operaciones de alto volumen y comercios que necesiten creación automática de pedidos, sincronización del estado de pago, pagos por lotes o conexión con sistemas financieros internos.
¿Hay que completar la revisión antes de recibir la documentación de API?
La página pública explica las capacidades centrales de integración; la especificación completa de campos, el sandbox, la nomenclatura de eventos y la configuración de permisos se proporcionan tras la revisión del comercio, dentro del alcance de servicio aprobado.
¿Webhook necesita verificación de firma?
Se recomienda usar verificación de firma, manejo de reintentos y diseño idempotente para evitar abonos duplicados o sincronización incorrecta de estado.
¿Puedo usar solo Dashboard sin API?
Sí. Los comercios de bajo volumen pueden empezar con Dashboard, Payment Link o Invoice; los de alto volumen o de plataforma pueden incorporar API después.
¿Listo para consultar? Reúna los datos básicos de una vez
Empresa, región, uso y escala esperada: cuanto más claro, más rápida la respuesta.Los documentos de identidad pueden enviarse después según la lista de revisión; no hacen falta copias en el primer contacto.
Iniciar consulta comercial