Revogar inscrição
Desliga a inscrição e para na hora todas as entregas, inclusive as tentativas pendentes.
apiKeyAuthorizationBearer <token>Chave de API no header Authorization: Bearer <chave de API>.
id*stringid da inscrição, em ULID (26 caracteres).
Inscrição revogada.
application/json- response
Inscrição de webhook. Nunca inclui o secret.
id*stringIdentificador da inscrição, em ULID.
ownerId*integerId da conta dona da inscrição. Vem da chave de API; não é enviado no corpo.
subscribedEvents*array<>Eventos que a inscrição recebe.
callbackUrl*stringURL que recebe os eventos.
uristatus*WebhookSubscriptionStatusactive: recebe eventos. paused: não recebe; volta com Ativar.
revoked: desligada.
"active""paused""revoked"failureCount*integerTentativas de entrega que falharam desde a última entrega com
sucesso. Conta cada nova tentativa, não cada evento; volta a 0 na
próxima entrega aceita.
lastFailureAt*|Data e hora (ISO 8601, UTC) da última falha de entrega, ou null.
date-timecreatedAt*stringData e hora de criação (ISO 8601, UTC).
date-timeupdatedAt*stringData e hora da última alteração (ISO 8601, UTC).
date-timecurl -X POST 'https://api.gates2b.com/webhook-subscriptions/string/revoke'{ "id": "01KTQRHR29PZ588RB1YQZWS4A6", "ownerId": 314, "subscribedEvents": [ "charge.paid", "charge.refunded", "payout.paid", "payout.failed" ], "callbackUrl": "https://loja.example.com/webhooks/pagamentos", "status": "revoked", "failureCount": 0, "lastFailureAt": null, "createdAt": "2026-06-15T14:00:00.000Z", "updatedAt": "2026-06-18T10:00:00.000Z"}Regras
- Use quando a URL deixar de existir ou o
secrettiver vazado. Para uma interrupção temporária, use Pausar inscrição. - Tentativas pendentes são descartadas e eventos novos não são gerados para a inscrição.
- A inscrição continua aparecendo em Listar inscrições, com
statusrevoked. - Depois de revogar, cadastre a nova URL com Criar inscrição. Ela recebe um
secretnovo.