CWallet
CWallet Developers Portal

Apificá tus cobros
al estilo Stripe en Web3.

REST API + 4 SDKs (Node, Python, PHP, Go) + checkout widget. Sandbox y live separados por key prefix. HMAC-signed webhooks. OpenAPI 3.1. Integración real en 5 minutos.

Quickstart 5 min API reference OpenAPI 3.1

Quickstart

De cero a producción en 5 pasos. Crear key, primer intent, render del QR, webhook HMAC, switch a live.

Empezar

Webhooks

5 eventos con payloads de ejemplo, verificación HMAC-SHA256, política de retries 6-attempt exponencial.

Ver eventos

API Reference

3 endpoints REST, schemas JSON, códigos de error, auth Bearer. Compatible OpenAPI 3.1 (Postman / Insomnia).

Ver endpoints
Demo Interactiva · Sandbox

Probá el widget ahora — sin instalar nada

Hacé click y vas a ver el mismo modal que verán los clientes de un comercio integrado. Generamos un intent sandbox por vos, abrimos el widget con su QR y a los ~6 segundos lo auto-completamos para que veas la transición a payment.success.

  1. 1 Hacés click en el botón →
  2. 2 Generamos un sandbox intent + abre el modal con QR
  3. 3 A los 6 s la simulación dispara status='paid'
  4. 4 El widget detecta y fire onSuccess(event)

Rate-limited a 5 demos por minuto por IP. Ningún USDT real se mueve.

1

Autenticación Segura

Todas las llamadas a la API deben estar autenticadas mediante una API Key de Terminal. Podés generar una desde tu panel de "Mi Comercio" al crear una nueva Caja/Terminal. Pasa esta llave en el header Authorization: Bearer <api_key>.

Mantén tu API Key protegida

Nunca expongas llaves secretas en tu código de cliente. Realizá los llamados a la API de creación de intenciones siempre desde tu backend (NodeJS, PHP, Python, Go).

2

Crear Intención de Pago (Checkout)

Cuando tu cliente esté listo para realizar el pago, llamá a este endpoint para fijar el monto y token. Podés elegir integrarlo mediante API REST directa, nuestro SDK de NodeJS o el Widget de Checkout interactivo para tu frontend.

# Sandbox (test, no mueve plata real):
curl -X POST https://getcwallet.app/api/v1/create-payment-intent \
  -H "Authorization: Bearer cwt_test_XXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{ "amount_usdt": 15.50 }'

# Producción (cobros reales en USDT TRC20):
curl -X POST https://getcwallet.app/api/v1/create-payment-intent \
  -H "Authorization: Bearer cwt_live_XXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{ "amount_usdt": 15.50 }'
3

Webhooks & Confirmación instantánea

Una vez que el cliente confirme el pago desde su app de CWallet, notificamos a tu servidor de manera atómica con firma criptográfica simétrica (`SHA-256`) para evitar falsificaciones.

Ejemplo de Evento Recibido

{
  "event": "payment.success",
  "intent_id": "pi_8b72...a48a",
  "transfer_id": "tx_c39...f2a4",
  "amount_usdt": 15.50,
  "terminal_id": "terminal_caja_1_uuid",
  "timestamp": "2026-05-18T01:05:00Z"
}
4

Arqueos de Caja y Balances Diarios (POS)

Si estás integrando CWallet en cajas registradoras físicas, tu software de punto de venta (POS) puede solicitar un reporte en vivo para cierres y aperturas de caja diarios. Obtené el monto exacto facturado por la caja mediante su clave de API.

GET/v1/get-terminal-sales

Ejemplo de Respuesta del Arqueo:

{
  "success": true,
  "merchant_name": "Supermercado El Sol",
  "terminal_name": "Caja Registradora 5",
  "reconciliation_period": {
    "start": "2026-05-18T00:00:00.000Z",
    "end": "2026-05-18T22:25:00.000Z"
  },
  "summary": {
    "total_collected": 1425.50,
    "currency": "USDT",
    "sales_count": 12
  }
}

SDKs y Plugins

Líderes de E-commerce

Ofrecé la pasarela de pago más simple del ecosistema cripto. Reducí carritos abandonados automatizando el checkout con QR directo.

Crear Cuenta de Dev