Skip to main content
POST
/
api
/
v1
/
merchants
/
me
/
webhook
curl -X POST https://crypto.cucu.ai/api/v1/merchants/me/webhook \
  -H "X-API-Key: sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://tu-servidor.com/webhooks/cucu-crypto",
    "events": ["payment.confirmed", "payment.failed", "charge.expired", "charge.cancelled"]
  }'

{
  "url": "https://tu-servidor.com/webhooks/cucu-crypto",
  "events": ["payment.confirmed", "payment.failed", "charge.expired", "charge.cancelled"],
  "rotated": false,
  "secret": "wh_sk_xxxxxxxxxxxxxxxxxxxx"
}
Registra la URL de tu servidor para recibir eventos en tiempo real. Ver Webhooks Salientes para el formato de los eventos y la verificación de firma.

​
POST /merchants/me/webhook — Registrar o Rotar URL

​
Headers

HeaderTipoReqDescripción
X-API-KeystringSíAPI Key del merchant
Content-TypestringSíapplication/json

​
Request Body

CampoTipoReqDescripción
urlstringSíURL HTTPS donde CUCU enviará los eventos. Debe ser accesible desde internet.
secretstringNoSecreto para firmar los webhooks. Si se omite, CUCU genera uno automáticamente.
eventsarrayNoLista de eventos a suscribir. Si se omite, se suscriben todos.
rotation_grace_secondsintNoSegundos que el secreto anterior sigue válido durante una rotación. Default: 3600.

​
Response

CampoTipoDescripción
urlstringURL registrada.
eventsarrayEventos suscritos.
rotatedbooleantrue si se rotó el secreto.
secretstringSecreto de firma. Solo aparece en el registro inicial o rotación. Guárdalo.
curl -X POST https://crypto.cucu.ai/api/v1/merchants/me/webhook \
  -H "X-API-Key: sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://tu-servidor.com/webhooks/cucu-crypto",
    "events": ["payment.confirmed", "payment.failed", "charge.expired", "charge.cancelled"]
  }'

{
  "url": "https://tu-servidor.com/webhooks/cucu-crypto",
  "events": ["payment.confirmed", "payment.failed", "charge.expired", "charge.cancelled"],
  "rotated": false,
  "secret": "wh_sk_xxxxxxxxxxxxxxxxxxxx"
}

​
POST /merchants/me/webhook/test — Probar Webhook

Envía un evento sintético webhook.test a tu URL registrada para verificar la integración end-to-end. 
curl -X POST https://crypto.cucu.ai/api/v1/merchants/me/webhook/test \
  -H "X-API-Key: sk_live_xxxx"
Response 202 Accepted 
{
  "delivery_id": "d4e5f6a7-b8c9-0123-defa-456789abcdef",
  "status": "enqueued"
}

​
DELETE /merchants/me/webhook — Eliminar Webhook

curl -X DELETE https://crypto.cucu.ai/api/v1/merchants/me/webhook \
  -H "X-API-Key: sk_live_xxxx"
Response: 204 No Content