Overview
In this section we give you a practical overview of SP Cuvex and how to get started with the integration.
What is SP Cuvex (platform overview)
SP Cuvex is a Virtual POS that lets you receive payments in stablecoins while keeping control of your funds.
Our approach is that you keep custody of your assets: you don’t delegate funds to a third party and you operate with your own wallet infrastructure.
The platform includes APIs for collections, delivered in a SaaS model with enterprise SLA and continuous technical support.
Main components
- Stablecoin collections: create payments, receive funds in the designated wallet, and check their status at any time.
- Real‑time webhooks: receive events such as
PAYMENT_CREATED,PAYMENT_FINISHED,PAYMENT_LATE_FINISHED,PAYMENT_EXPIRED, andPAYMENT_FAILEDto keep your back office synchronized. - Wallet linking: integrate your receiving addresses per network/token and validate their operation with our random micro‑payment during onboarding.
Environments
-
Sandbox (Testing)
- Base endpoint:
https://sp-dev.cuvex.io/ecommerce - If you need help integrating our services, contact us at sp@cuvex.io.
- Base endpoint:
-
Production
- Base endpoint:
https://sp.cuvex.io/ecommerce
- Base endpoint:
End‑to‑end flow
- Onboarding: provide your details; we perform the setup and deliver credentials.
- Certification: we send you a random micro‑payment and you confirm the exact amount.
- Create payment: call
POST /v1/paymentsand display the address or contract where your customer will pay. - Confirmation: listen to the webhook and/or query
GET /v1/payments/{paymentId}to check status. - Post‑payment: record the sale, issue the invoice, and if applicable, manage fiat settlements from your own wallet under your custody.
- Refunds: refunds are entirely in your hands. SP Cuvex is a non‑custodial service, so any refund management must be performed exclusively by you.
Networks and stablecoins
We work with leading stablecoins (e.g., USDT/USDC) and widely adopted networks. The set of enabled networks/tokens is agreed with you during onboarding, depending on your use case and compliance requirements.
Security and compliance
- Custody in your hands: you control funds at all times.
- Infrastructure and support: SaaS model with SLA, 24/7 support (with response time levels based on your contracted tier), and controlled deployments.
- Communication security: all communications use HTTPS with TLS 1.3 only, via an SSL certificate with RSA 2048‑bit algorithm.
- CORS: designed exclusively for server‑to‑server communications, CORS restrictions do not apply.
Quick resources
- Swagger Ecommerce API: https://sp.cuvex.io/ecommerce/swagger-ui/index.html#/
- Webhook: see the full guide in the Webhook section.