Developers
API que cubren cobro multicanal, liquidación y Payout
Payment API gestiona cobro multicanal; las API de liquidación y Payout cubren conversión de gran escala y desembolsos medianos. Webhook e informes permiten seguimiento y conciliación en el sistema del comercio.
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 Payout (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 Payout para una vista unificada de 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
¿Qué comercios encajan con API?
API encaja en plataformas y comercios de alta frecuencia que necesitan órdenes automáticas, sync de estado, payout masivo o integración financiera.
¿Se requiere revisión comercial antes de la documentación API?
Las páginas públicas muestran capacidades centrales; campos, sandbox, eventos y permisos se entregan tras la revisión según el alcance.
¿Se requiere verificación de firma Webhook?
Los sistemas del comercio deben usar verificación de firma, reintentos e idempotencia para evitar acreditaciones duplicadas o sync erróneo.
¿Puedo usar solo Dashboard sin API?
Sí. Comercios de baja frecuencia pueden empezar con Dashboard, Payment Link o Invoice; los de alto volumen o plataforma pueden añadir API después.
¿La API admite payouts?
Según la revisión, admite solicitudes de payout cripto o por canal designado, consulta de estado, causas de fallo y conciliación de informes.
¿Qué se necesita habitualmente para la integración de prueba?
Normalmente URLs de callback, contacto técnico, escenarios previstos, flujos 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.