curl --request PATCH \
--url https://api.qbank.cl/platform/v1/webhooks/subscriptions/{subscriptionID} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"status": "disabled"
}
'
{
"id": "8e7f6a5b-4c3d-2e1f-0a9b-8c7d6e5f4a3b",
"event_type": "payout_status_changed",
"callback_url": "https://api.myapp.com/webhooks/cbpay",
"status": "disabled",
"created_at": "2026-07-07T12:00:00Z"
}{
"error": "invalid_status",
"message": "status must be active or disabled"
}{
"error": "unauthorized",
"message": "invalid or missing credentials"
}{
"error": "not_found",
"message": "resource not found"
}Desactivar o reactivar una suscripción de webhook
Alterna una suscripción de la cuenta entre active y disabled. Una suscripción disabled deja de recibir eventos NUEVOS; las entregas ya encoladas siguen saliendo. Idempotente: repetir el estado vigente es un no-op 200. Las suscripciones nunca se borran — desactivar es la forma de desuscribirse. Ownership aplicado: una suscripción de otra cuenta responde 404 (es indistinguible de una inexistente).
PATCH
/
v1
/
webhooks
/
subscriptions
/
{subscriptionID}
curl --request PATCH \
--url https://api.qbank.cl/platform/v1/webhooks/subscriptions/{subscriptionID} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"status": "disabled"
}
'
{
"id": "8e7f6a5b-4c3d-2e1f-0a9b-8c7d6e5f4a3b",
"event_type": "payout_status_changed",
"callback_url": "https://api.myapp.com/webhooks/cbpay",
"status": "disabled",
"created_at": "2026-07-07T12:00:00Z"
}{
"error": "invalid_status",
"message": "status must be active or disabled"
}{
"error": "unauthorized",
"message": "invalid or missing credentials"
}{
"error": "not_found",
"message": "resource not found"
}Autorizaciones
JWT de sesión (de register/login) o llave de API (pk_...).
X-API-Key: <token> se acepta como header alternativo.
Parámetros de ruta
Cuerpo
application/json
Opciones disponibles:
active, disabled