---
updatedAt: 2026-10-05T20:40:22.000Z
agentTools:
siteIndex: https://docs.cielo.com.br/llms.txt
projectIndex: https://docs.cielo.com.br/gateway/llms.txt
---
# Cancelar uma transação de débito
Cancela ou estorna uma transação de cartão de débito.
| Ambiente | Método | Endpoint |
| :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------ |
| Sandbox | put
| `https://apisandbox.braspag.com.br/v2/sales/{PaymentId}/void` |
| Produção | put
| `https://api.braspag.com.br/v2/sales/{PaymentId}/void` |
Consulte os [Códigos de retorno de cancelamento.](https://docs.cielo.com.br/gateway/reference/codigos-cancelamento)
> **A API permite cancelar transações individualmente.**
>
> Para cancelar um grupo de transações, utilize o portal e-commerce. Saiba mais em:
>
> * Como cancelar transações em lote (até 23h59 do dia da criação da transação);
> * Como estornar transações em lote (a partir do dia seguinte à criação da transação).
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "cartão-de-débito",
"version": "1.0"
},
"servers": [
{
"url": "https://apisandbox.braspag.com.br"
}
],
"security": [
{}
],
"paths": {
"/v2/sales/{PaymentId}/void": {
"put": {
"summary": "Cancelar uma transação de débito",
"description": "Cancela ou estorna uma transação de cartão de débito.",
"operationId": "cancelar-uma-transacao-de-debito",
"parameters": [
{
"name": "MerchantId",
"in": "header",
"description": "Identificador da loja na API. Tamanho: 36.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "PaymentId",
"in": "path",
"description": "Campo identificador do pedido. Tamanho: 36.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "MerchantKey",
"in": "header",
"description": "Chave pública para autenticação dupla na API. Tamanho: 40.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "RequestId",
"in": "header",
"description": "Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT. Tamanho: 36.",
"schema": {
"type": "string"
}
},
{
"name": "Amount",
"in": "query",
"description": "Valor, em centavos, a ser cancelado/estornado. Observações.: 1. Verifique se a adquirente contratada suporta a operação de cancelamento ou estorno. 2. Caso o valor de Amount seja informado como \"0\" (zero), ou esse parâmetro não seja enviado, será considerado um estorno total do valor capturado. Tamanho: 15.",
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"Status\": 10,\n \"ReasonCode\": 0,\n \"ReasonMessage\": \"Successful\",\n \"ProviderReturnCode\": \"9\",\n \"ProviderReturnMessage\": \"Operation Successful\",\n \"Links\": [\n {\n \"Method\": \"GET\",\n \"Rel\": \"self\",\n \"Href\": \"https://apiquerysandbox.braspag.com.br/v2/sales/{PaymentId}\"\n }\n ]\n}"
}
},
"schema": {
"type": "object",
"properties": {
"Status": {
"type": "integer",
"example": 10,
"default": 0
},
"ReasonCode": {
"type": "integer",
"example": 0,
"default": 0
},
"ReasonMessage": {
"type": "string",
"example": "Successful"
},
"ProviderReturnCode": {
"type": "string",
"example": "9"
},
"ProviderReturnMessage": {
"type": "string",
"example": "Operation Successful"
},
"Links": {
"type": "array",
"items": {
"type": "object",
"properties": {
"Method": {
"type": "string",
"example": "GET"
},
"Rel": {
"type": "string",
"example": "self"
},
"Href": {
"type": "string",
"example": "https://apiquerysandbox.braspag.com.br/v2/sales/{PaymentId}"
}
}
}
}
}
}
}
}
}
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```