Skip to main content
POST
/
api
/
v1
/
payments
/
{identifier}
/
cancel
Cancelar Pagamento
curl --request POST \
  --url https://zeus-sandbox.autorizou.dev/api/v1/payments/{identifier}/cancel \
  --header 'Authorization: Bearer <token>'
Cancela um pagamento autorizado antes da liquidação. Use para reverter uma autorização de cartão (estorno da reserva) ou para invalidar uma cobrança PIX/boleto ainda em aberto.
Para devolver um pagamento já capturado/pago, utilize o endpoint de Reembolso. O cancelamento atua apenas sobre transações que ainda não foram liquidadas.

​
Parâmetros da Requisição

​
identifier
string
required
Identificador UUID do pagamento a ser cancelado.
O corpo da requisição é vazio — o pagamento é identificado pela URL.

​
Exemplos de Requisição

curl -X POST https://zeus-sandbox.autorizou.dev/api/v1/payments/295e3b31-1684-4355-8ee5-4bbf7b97589b/cancel \
    -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc" \
    -H "Content-Type: application/json"

​
Exemplo de Resposta

{
  "id": "295e3b31-1684-4355-8ee5-4bbf7b97589b",
  "status": "cancelled",
  "amount": 10000,
  "cancelled_at": "2026-06-24T14:30:00Z"
}

​
Códigos de Erro

O pagamento não pode ser cancelado no estado atual (por exemplo, já foi liquidado ou já está cancelado).
{
    "message": "Payment cannot be cancelled in its current state.",
    "error": "payment_cancel_error"
}
Nenhum pagamento foi encontrado para o identifier informado.
{
    "message": "Payment not found."
}