Developers
API integrada en cobro multicanal, liquidación y pago de facturas
Payment API gestiona cobro multicanal; Settlement y pago de facturas API corresponden a conversión de grandes montos y desembolsos medianos. Webhook e informes permiten seguimiento y conciliación.
API Coverage
API alineada con los tres servicios principales
Payment API (cobro multicanal)
Crear órdenes de cobro, obtener dirección de pago, consultar estado y procesar confirmaciones.
Settlement API (liquidación)
Solicitar cotización de liquidación, consultar estado y comisiones de conversión o retención de cripto.
API de pago de facturas (desembolso)
Iniciar payout medianos por wallet cripto, fiat multimoneda y canales locales; consultar estado y fallos.
Webhook & Dashboard
Recibir eventos de cobro, liquidación y pago de facturas; vista unificada para operaciones y finanzas.
POST /v1/payment-intents
{
"merchant_order_id": "INV-2026-0618",
"amount": "2480.00",
"currency": "BTC",
"network": "BTC",
"settlement_preference": ["HKD", "USD"],
"webhook_url": "https://merchant.example/webhook"
}
Webhook event:
payment.confirmed
settlement.review_required
Operational Design
Diseñado para operaciones reales, no solo un botón de pago
Los problemas no son solo cobro, sino conciliación, sincronización, cadenas incorrectas, fallos de payout, comisiones e informes. La API debe diseñarse con Dashboard, Webhook y revisión manual.
- Admite idempotency key para evitar órdenes o payouts duplicados
- Se recomienda validación de firma y reintentos en Webhook
- Operaciones de alto riesgo o grandes montos pueden devolver estado review_required
- Informes CSV para conciliación financiera y detalle de comisiones
Secure Integration
Confirmar permisos, firma y reglas de conciliación antes del onboarding
El sitio público muestra capacidades principales; campos API, eventos, entorno de prueba y flujos de estado se entregan tras revisión.
- Los permisos de API key deben separarse por uso; no mezclar cobro y payout
- Se recomienda firma, reintentos y diseño idempotente en Webhook
- El sistema financiero debe conciliar transacciones, comisiones, liquidación y payout
- Operaciones de alto riesgo o payout de grandes montos pueden requerir revisión manual
FAQ
Preguntas frecuentes
¿Para qué comercios es adecuada la API?
La API es adecuada para plataformas, alto volumen, creación automática de órdenes, sincronización de pagos, payout masivo o integración con sistemas financieros internos.
¿Es obligatorio completar la revisión para obtener documentación API?
La página pública muestra capacidades principales; campos, entorno de prueba, eventos y permisos se entregan tras revisión según alcance.
¿Debe validarse la firma del Webhook?
Se recomienda validación de firma, reintentos y diseño idempotente para evitar acreditaciones duplicadas o estados incorrectos.
¿Puede usar solo Dashboard sin API?
Sí. Comercios de baja frecuencia pueden usar Dashboard, Payment Link o Invoice; plataformas o alto volumen pueden integrar API.
¿La API admite desembolsos?
Según revisión: solicitudes de payout cripto o por canal, consulta de estado, motivos de fallo e informes de conciliación.
¿Qué preparación suele requerir la integración de prueba?
Suele requerir URL de callback, contacto técnico, escenarios previstos, flujo de prueba y manejo de webhook.
¿Necesita documentación de integración API?
Tras la revisión, podemos indicar integración, pruebas y configuración de webhook según su arquitectura.