Crear endpoint

Registra una URL HTTPS para recibir eventos firmados de KUTI.

POSThttps://api.kuti.pe/v1/webhook-endpoints

signing_secret se devuelve SOLO en esta respuesta. El endpoint queda ligado al modo de tu API key (test o live). events: lista de tipos o ["*"] para todos.

Parámetros del body

url

stringrequerido

URL HTTPS de tu servidor.Ej: https://merchant.example.com/webhooks/kuti

events

arrayrequerido

Tipos a suscribir, o ["*"] para todos.Ej: ["payment.succeeded", "payment.failed"]

description

stringopcional

Etiqueta interna.Ej: Producción

Language

Credentials

Header

Authorization

Secret key de developer · ejemplos con librerías estándar (aún sin SDK)

cURL Request

curl -s 'https://api.kuti.pe/v1/webhook-endpoints' \
  -X POST \
  -H 'Authorization: Bearer kuti_live_…' \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://merchant.example.com/webhooks/kuti",
  "description": "Producción",
  "events": [
    "payment.succeeded",
    "payment.failed"
  ]
}'

Librería estándar · sin SDK propio

Response

Elige un ejemplo de respuesta:

application/json

201Created

{
  "success": true,
  "message": "Webhook endpoint created",
  "data": {
    "id": "we_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "url": "https://merchant.example.com/webhooks/kuti",
    "description": "Producción",
    "enabled_events": [
      "payment.succeeded",
      "payment.failed"
    ],
    "status": "ENABLED",
    "livemode": true,
    "signing_secret": "whsec_a1b2c3d4e5f6…",
    "created_at": "2026-09-04T10:48:59.556906Z"
  }
}