---
title: "POST /charges/cancel"
method: POST
path: "/charges/cancel"
tags: ["Charges"]
---

# POST /charges/cancel

`POST /charges/cancel`

Reversão ou Cancelamento de uma charge.<br> Pode ser utilizado o `id` ou o `initiator_id`.<br> Se os dois forem informados, será usado o `id`.<br><br>         A autenticação no endpoint é feita da seguinte forma:
  * **Bearer Token Authorization**: Token JWT.

## Headers

- `Host` string, required

## Request body

- PostChargeCancelRequest
  - `id` string — Identificador da charge. Obrigatório se não for informado o `initiator_id`
  - `initiator_id` string — Identificador externo que pode ser utilizado em reversões. Obrigatório se não for informado o `id`
  - `amount` integer, required — Valor a ser revertido (valor da autorização)
  - `reason` string — Motivo da solicitação do cancelamento
  - `initiator_operation_id` string — Identificador externo que pode ser utilizado para identificar cada operação realizada
  - `card_transaction` object — Informações específicas para cancelamentos de transações utilizando o método de pagamento cartão. Este nó é obrigatório apenas para transações da bandeira Banricompras com cartão presente. Caso contrário, deve ser omitido
    - `card` object
      - `cvv` string, int32 — Código de segurança do cartão
      - `emv_data` string — Dados obtidos do chip do cartão
      - `track_1` string — Trilha 1 de dados do cartão
      - `track_2` string — Trilha 2 de dados do cartão
      - `track_3` string — Trilha 3 de dados do cartão
    - `authentication` object
      - `type` 'online_pin' | 'offline_pin', required — Método de autenticação do cliente
      - `online_pin` object
        - `ksi` string, binary — ksi
        - `ksn` string, binary — ksn
        - `pin_block` string, binary — pin_block

## Response `200`

OK

- PostChargeCancelResponse
  - `id` string, required — Identificador da charge
  - `amount` integer, required — Valor estornado/revertido em centavos
  - `payment_method` 'card', required — Payment method da charge
  - `status` 'authorized' | 'paid' | 'canceled' | 'declined', required — Status atual da Charge
  - `card_transaction` object
    - `result` 'success' | 'failed', required — Resultado da operação que foi executada
    - `transaction_id` string, required — Identificador da transação emitido pelo provedor
    - `operation_id` string, required — Identificador da operação gerado pela adquirente
    - `acquirer_message` string — Mensagem de resultado da operação retornada pela adquirente
    - `acquirer_return_code` string, required — Código de resultado da operação retornado pela adquirente
    - `authorization_code` string — Código de autorização retornado pelo emissor
    - `card` object
      - `remaining_balance` integer — Saldo restante no cartão, caso seja informado pela adquirente
    - `additional_data` object[] — Detalhamento de informações adicionais
      - `name` string, required — Nome da propriedade adicional
      - `value` string, required — Valor da propriedade adicional
    - `currency_conversion` object
      - `converted_amount` number, required — Valor de cancelamento da transação na moeda de autorização do portador
      - `currency_exp` number — Expoente da moeda do portador. (Número de digitos após o separador de decimal)
      - `currency_label` string — Nome da moeda de autorização da transação no cartão do portador. Padrão ISO 3 caracteres
      - `exchange_rate` number, float — Cotação de conversão entre as moedas do portador e do merchant
      - `markup` number, float — Spread utilizado para conversão

## Other responses

- `400` — BadRequest
- `401` — Não autorizado
- `404` — NotFound

---

[API](https://skmtc.dev/stone/apis/payments-processing-acquiring-paymentcardapi.md) · [All operations](https://skmtc.dev/stone/apis/payments-processing-acquiring-paymentcardapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stone/payments-processing-acquiring-paymentcardapi/revisions/29bc4962fa98/schema)