---
title: "Cancelar pagamento"
method: POST
path: "/charges/{charge_id}/cancel"
---

# Cancelar pagamento

`POST /charges/{charge_id}/cancel`

## Request

- Base URL: `https://sandbox.api.pagseguro.com`
- URL: `https://sandbox.api.pagseguro.com/charges/{charge_id}/cancel`
- Auth: none required

## Path parameters

- `charge_id` string, required

## Headers

- `Authorization` string

## Request body

- object
  - `amount` object: Contém as informações do valor da cobrança.
    - `value` integer: Valor a ser cobrado em centavos. Apenas números inteiros positivos. <br/>Exemplo: R$ 1.500,99 = 150099
  - `splits` object: Utilizado para cancelamento customizado de pedidos com divisão de pagamento. Informa o método e os recebedores envolvidos.
    - `method` 'FIXED' | 'PERCENTAGE': Especifica como a divisão do cancelamento será realizada, podendo ser: <br/> - `FIXED`: deve ser informado os valores monetários a ser debitado da conta de cada recebedor. <br/> `PERCENTAGE`: deve ser informado o percentual do montante do cancelamento a ser debitado da conta de cada recebedor.
    - `receivers` object[]: Especifica as contas que terão valores debitados após o cancelamento, informando o valor ou percentual a ser debitado.
      - `account` object: Informa os dados do recebedor que terá fundos debitados da conta após o cancelamento.
        - `id` string: Identificador da conta do recebedor participante da operação de cancelamento.
      - `amount` object: Informa o valor ou percentual da operação de cancelamento a ser debitado da conta do recebedor.
        - `value` integer: Valor fixo ou percentual que deve ser debitado da conta do recebedor participante da operação de cancelamento.
      - `configurations` object: Informa se o recebedor será responsável por arcar com as táxas reembolsáveis ou com as diferenças decorrentes dos arredondamentos.
        - `refund` object: Objeto especificando se o recebedor será responsável por arcar diferenças decorrentes de arredondamentos.
          - `rounding_liable` object: Objeto especificando se o recebedor será responsável por arcar diferenças decorrentes de arredondamentos.
            - `apply` boolean: Informa se o recebedor será responsável por arcar com diferenças decorrentes do processo de arredondamentos para duas casas decimais.
        - `fee_liable` object: Objeto especificando se o recebedor irá arcar com as taxas reembolsáveil.
          - `percentage` integer: Especifica o valor percentual que será debitado da conta do recebedor para arcar com o valor das taxas reembolsáveis. **Como somente um recebedor pode ser responsável, sempre deve ser informado o valor de 100 (100%)**.

## Response `201`

201

- object
  - `id` string
  - `reference_id` string
  - `status` string
  - `created_at` string
  - `paid_at` string
  - `description` string
  - `amount` object
    - `value` integer
    - `currency` string
    - `summary` object
      - `total` integer
      - `paid` integer
      - `refunded` integer
  - `payment_response` object
    - `code` string
    - `message` string
    - `reference` string
  - `payment_method` object
    - `type` string
    - `installments` integer
    - `capture` boolean
    - `card` object
      - `brand` string
      - `first_digits` string
      - `last_digits` string
      - `exp_month` string
      - `exp_year` string
      - `holder` object
        - `name` string
  - `links` object[]
  - `notification_urls` string[]
  - `metadata` object

---

[API](https://skmtc.dev/pagbank/apis/nova-plataforma-sandbox.md) - [All operations](https://skmtc.dev/pagbank/apis/nova-plataforma-sandbox/llms.txt) - [OpenAPI document](https://skmtc.dev/pagbank/apis/nova-plataforma-sandbox/revisions/0838a2b3f755?raw)