Overview
En esta sección te damos un repaso práctico de SP Cuvex y de cómo empezar a integrarte.
Qué es SP Cuvex (visión de la plataforma)
SP Cuvex es un TPV Virtual que te permite recibir pagos en stablecoins manteniendo el control de tus fondos.
Nuestro enfoque es que tú conserves la custodia de tus activos: no delegas los fondos a un tercero y operas con tu propia infraestructura de wallets.
La plataforma incluye APIs para cobros, con un modelo SaaS con SLA empresarial y soporte técnico continuo.
Componentes principales
- Cobros en stablecoins: crea pagos, recibe el importe en el wallet designado y consulta el estado en todo momento.
- Webhooks en tiempo real: recibe eventos de
PAYMENT_CREATED,PAYMENT_FINISHED,PAYMENT_LATE_FINISHED,PAYMENT_EXPIREDyPAYMENT_FAILEDpara sincronizar tu backoffice. - Vinculación de Wallets: integra tus direcciones de recepción por red/token y valida su operatividad con nuestro micro‑pago aleatorio durante el onboarding.
Entornos
-
Sandbox (Testing)
- Endpoint base:
https://sp-dev.cuvex.io/ecommerce - Si necesitas ayuda para integrar nuestros servicios, escribenos a sp@cuvex.io.
- Endpoint base:
-
Producción
- Endpoint base:
https://sp.cuvex.io/ecommerce
- Endpoint base:
Flujo de extremo a extremo
- Onboarding: nos dejas tus datos; realizamos la configuración y te entregamos credenciales.
- Certificación: te enviamos un micro‑pago aleatorio y tú confirmas el importe exacto.
- Crear pago: llamas a
POST /v1/paymentsy mostramos la dirección o contrato donde tu cliente pagará. - Confirmación: escuchas el webhook y/o consultas
GET /v1/payments/{paymentId}para conocer el estado. - Post‑pago: registras la venta, emites factura y, si aplica, gestionas desde tu propio wallet que solo tú custodias liquidaciones a fiat.
- Post‑pago: las devoluciones, solo están en tu mano realizarlas. SP Cuvex es un servicio no custodio, por lo que para cualquier gestión de devoluciones, solo tú puedes llevarlas a cabo.
Redes y stablecoins
Trabajamos con stablecoins líderes (p. ej., USDT/USDC) y redes de alto uso. El detalle de redes/tokens habilitados lo acordamos contigo durante el onboarding, en función de tu caso de uso y requisitos de cumplimiento.
Seguridad y cumplimiento
- Custodia en tus manos: tú controlas los fondos en todo momento.
- Infraestructura y soporte: modelo SaaS con SLA, soporte 24/7 (con niveles de plazos de respusta en base a tu rango contratado), y despliegues controlados.
- Seguridad en las comunicaciones: todas las comunicaciones utilizan exclusivamente HTTPS con TLS 1.3, a través de un certificado SSL con algoritmo RSA de 2048 bits.
- CORS: diseñada exclusivamente para comunicaciones server-to-server, no aplican restricciones CORS.
Recursos rápidos
- Swagger Ecommerce API: https://sp.cuvex.io/ecommerce/swagger-ui/index.html#/
- Webhook: consulta la guía completa en la sección Webhook.