---
title: "Criar Cancelamento"
method: POST
path: "/cancellations"
---

# Criar Cancelamento

`POST /cancellations`

## Request

- Base URL: `https://sandbox.api.pagseguro.com`
- URL: `https://sandbox.api.pagseguro.com/cancellations`
- Auth: none required

## Headers

- `Authorization` string, required
- `x-idempotency-key` string

## Request body

- object
  - `source_id` string, required: Identificador do recurso que será cancelado. Exemplo: `CHAR_F87334AC-BB8B-42E2-AA85-8579F70AA328`
  - `reference_id` string: Identificador único atribuído para o cancelamento. Exemplo: `ex-0001`
  - `amount` object: Contém as informações do valor a ser cancelado.
    - `value` integer: Valor a ser cobrado em centavos. Apenas números inteiros positivos. <br/>Exemplo: R$ 1.500,99 = 150099

## Response `201`

- object
  - `source_id` string
  - `reference_id` string
  - `id` string
  - `type` 'FULL' | 'PARTIAL'
  - `operation` 'BOLETO_VOIDED' | 'PIX_REFUNDED'
  - `status` string
  - `amount` object
    - `value` integer
    - `currency` string
  - `links` object[]
    - `rel` 'SELF' | 'CHARGE'
    - `href` string
    - `method` 'GET' | 'POST' | 'DELETE' | 'PUT'

## Changes

- **2026-11-03** `0838a2b3f755`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pagbank/apis/nova-plataforma-sandbox/changes/cancellations/post.md)

---

[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)