Expira um token identificado pelo token ID especificado para o tenant atual.
DELETE /v2/tokenization/{tokenId} · versão da spec v2 · coleção Postman e spec
Esta operação é tipicamente usada para invalidar um token antes da expiração natural. O token deve pertencer ao contexto do tenant atual. Se o token não existir ou já estiver expirado, a resposta indicará o status apropriado.
Parâmetros
| Nome | Onde | Tipo | Obrigatório | Descrição |
|---|---|---|---|---|
tokenId | path | string | sim | O identificador único do token a ser expirado. |
Corpo da requisição
application/json
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
reason | string | não |
Respostas
| Status | Descrição | Formato |
|---|---|---|
| 200 | Sucesso: o token foi expirado. | sem corpo |
| 400 | Bad Request | application/json |
| 401 | Unauthorized | application/json |
| 403 | Forbidden | application/json |
| 404 | Not Found | application/json |
| 500 | Internal Server Error | sem corpo |
Respostas de erro seguem o Problem Details (RFC 9457): trate pelo campo code e consulte o catálogo de erros.
Exemplo
curl -X DELETE "https://api-payments.sand-fintech.com/v2/tokenization/{tokenId}" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d @corpo.json