---
title: "Cancelamento (Stone Online)"
url: "https://devcenter.stone.com.br/legacy-stone-online-cancelamento-1"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_Cancelamento+(Stone+Online),props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9sZWdhY3ktc3RvbmUtb25saW5lLWNhbmNlbGFtZW50by0xIg,s_-HZJDWyqvfxNWf5o.png"
---

# Cancelamento

Documentação legada · Produtos e Tipos de transação

Documentação legada do Stone Online

Esta página descreve a **API Stone Online** (versão legada). Para projetos novos, explore o **[API Catalog](https://devcenter.stone.com.br/catalog)**.

## [Introdução](#introdução)

Neste item exemplificamos o modelo esperado pela nossa API para as requisições de cancelamentos.

## [Requests](#requests)

Abaixo está um exemplo de Cancelamento total por ChargId e suas resposta.

\*\*Endpoint: \*\*[https://payments.stone.com.br/v1/charges/cancel](https://payments.stone.com.br/v1/charges/cancel)

```json
{
  "card_transaction": {
    "authentication": {
      "type": "online_pin"
    }
  },
  "id": "17053916666784"
  "amount": 923
}
```

```json
{
  "id": "B7843C6C57836C5ETWGFU",
  "amount": 923,
  "payment_method": "card",
  "status": "canceled",
  "card_transaction": {
    "result": "success",
    "transaction_id": "cb42d188-aca6-46f2-a2c9-046cb6342f5d",
    "operation_id": "4d41314b-cb2d-4abe-b594-fd6875726e1b",
    "acquirer_message": "APPR",
    "acquirer_return_code": "0000"
  }
}
```

```json
{
  "error_code": "not_found",
  "details": {
    "message": "Transação não Encontrada"
  }
}
```

Abaixo está um exemplo de Cancelamento parcial por ChargId e suas resposta.

```json
{
  "card_transaction": {
    "authentication": {
      "type": "online_pin"
    }
  },
  "id": "17053916666789"
  "amount": 30
}
```

```json
{
  "id": "B7843C6C57836C5ETWGFU",
  "amount": 30,
  "payment_method": "card",
  "status": "paid",
  "card_transaction": {
    "result": "success",
    "transaction_id": "cb42d188-aca6-46f2-a2c9-046cb6342f5d",
    "operation_id": "4d41314b-cb2d-4abe-b594-fd6875726e1b",
    "acquirer_message": "APPR",
    "acquirer_return_code": "0000"
  }
}
```

```json
{
  "error_code": "not_found",
  "details": {
    "message": "Transação não Encontrada"
  }
}
```

## [Requests](#requests-1)

Abaixo está um exemplo de Cancelamento por Id próprio e suas resposta.

\*\*Endpoint: \*\*[https://payments.stone.com.br/v1/charges/cancel](https://payments.stone.com.br/v1/charges/cancel)

```json
{
  "card_transaction": {
    "authentication": {
      "type": "online_pin"
    }
  },
  "initiator_id": "b4d67123a94c4c77",
  "amount": 100,
  "reason": "4001"
}
```

```json
{
  "id": "B7843C6C57836C5ETWGFU",
  "amount": 100,
  "payment_method": "card",
  "status": "canceled",
  "card_transaction": {
    "result": "success",
    "transaction_id": "cb42d188-aca6-46f2-a2c9-046cb6342f5d",
    "operation_id": "4d41314b-cb2d-4abe-b594-fd6875726e1b",
    "acquirer_message": "APPR",
    "acquirer_return_code": "0000",
    "authorization_code": "ABC123"
  }
}
```

```json
{
  "error_code": "prefix_400",
  "details": {
    "message": "Transação Inválida"
  }
}
```

Abaixo temos uma lista com possíveis reason codes a serem utilizados no cancelamento.

| Cancellation Reason   | ID   |
| :-------------------- | :--- |
| Customer Cancellation | 4000 |
| Reason Unknown        | 4001 |
| Auth Malfunction      | 4002 |
| Card Removed          | 4007 |
| Timed Out             | 4021 |
| Terminal Shutdown     | 4013 |
| Invalid Response      | 4020 |
| ICC Declined          | 4351 |

---

**Jornada: [Transações de ecommerce](https://devcenter.stone.com.br/legacy-stone-online-digital)**  
Etapa 14 de 15

[**Etapa anterior**Captura posterior](https://devcenter.stone.com.br/legacy-stone-online-autorizacao-a-vista-com-captura-posterior)[**Próxima etapa**Retentativa](https://devcenter.stone.com.br/legacy-stone-online-retentativa)

Siga a Stone nas redes sociais

[](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ)

© Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57

Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP

Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.