Skip to main content
POST
/
api
/
v1
/
merchants
/
me
/
charges
curl -X POST https://crypto.cucu.ai/api/v1/merchants/me/charges \
  -H "X-API-Key: sk_live_xxxx" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50.00,
    "currency": "USDT",
    "name": "Suscripción Pro",
    "description": "Plan mensual",
    "expiration_minutes": 15,
    "metadata": {"user_id": "usr_abc123"}
  }'

{
  "charge_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "external_id": "CHG-20260125-00042",
  "provider": "cucu_pay",
  "provider_reference": "24572098437",
  "name": "Suscripción Pro",
  "description": "Plan mensual",
  "amount": 50.00,
  "currency": "USDT",
  "status": "created",
  "checkout_url": "https://crypto.cucu.ai/checkout/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "payment_url": "https://pay.cucu.ai/p/a1b2c3d4",
  "qrcode_link": null,
  "qr_content": null,
  "deeplink": null,
  "universal_url": null,
  "expires_at": "2026-01-25T15:30:00Z",
  "metadata": {"user_id": "usr_abc123"},
  "created_at": "2026-01-25T15:15:00Z",
  "updated_at": "2026-01-25T15:15:00Z"
}
Genera un cobro crypto. Devuelve la URL de pago y (para CUCU Direct B2B) el QR de Binance listo para mostrar.

​
Headers

HeaderTipoReqDescripción
X-API-KeystringSíAPI Key del merchant
Content-TypestringSíapplication/json
Idempotency-KeystringNoString único (UUID recomendado). Evita cobros duplicados en reintentos. Máx. 255 chars.

​
Request Body

CampoTipoReqDescripción
amountfloatSíMonto del cobro. Mayor que 0, máximo 1,000,000.
currencystringSíMoneda del cobro. Recomendado: USDT o USDC. Ver criptomonedas soportadas.
namestringSíNombre del producto o servicio. Máx. 255 chars.
descriptionstringNoDescripción del cobro. Máx. 1024 chars.
expiration_minutesintNoMinutos hasta expiración. Default: 15. Rango: 1–60.
metadataobjectNoDatos arbitrarios de tu sistema. No se procesan, solo se almacenan y retornan.

​
Response

CampoTipoDescripción
charge_idstringUUID interno CUCU — úsalo para consultar estado y en tus logs.
external_idstringReferencia legible por humanos.
providerstringProveedor que procesó el cobro: cucu_pay o binance.
statusstringEstado inicial. Siempre created.
checkout_urlstringURL de la página de pago CUCU (útil para redirección web).
payment_urlstring | nullURL alternativa del proveedor, cuando disponible.
qrcode_linkstring | nullURL imagen PNG del QR (CUCU Direct B2B / Binance).
qr_contentstring | nullTexto raw del QR — para generarlo en tu frontend.
deeplinkstring | nullDeep link para app móvil nativa.
universal_urlstring | nullUniversal link web — funciona en móvil y desktop.
expires_atstring (ISO 8601)Timestamp de expiración del cobro.
metadataobjectLos datos enviados en el request.
curl -X POST https://crypto.cucu.ai/api/v1/merchants/me/charges \
  -H "X-API-Key: sk_live_xxxx" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50.00,
    "currency": "USDT",
    "name": "Suscripción Pro",
    "description": "Plan mensual",
    "expiration_minutes": 15,
    "metadata": {"user_id": "usr_abc123"}
  }'

{
  "charge_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "external_id": "CHG-20260125-00042",
  "provider": "cucu_pay",
  "provider_reference": "24572098437",
  "name": "Suscripción Pro",
  "description": "Plan mensual",
  "amount": 50.00,
  "currency": "USDT",
  "status": "created",
  "checkout_url": "https://crypto.cucu.ai/checkout/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "payment_url": "https://pay.cucu.ai/p/a1b2c3d4",
  "qrcode_link": null,
  "qr_content": null,
  "deeplink": null,
  "universal_url": null,
  "expires_at": "2026-01-25T15:30:00Z",
  "metadata": {"user_id": "usr_abc123"},
  "created_at": "2026-01-25T15:15:00Z",
  "updated_at": "2026-01-25T15:15:00Z"
}