---
title: "Cancelar Cobrança Recorrente com Split"
method: DELETE
path: "/charges/{charge_id} "
---

# Cancelar Cobrança Recorrente com Split

`DELETE /charges/{charge_id} `

## Request

- Base URL: `https://api.pagar.me/core/v5`
- URL: `https://api.pagar.me/core/v5/charges/{charge_id} `
- Auth: HTTP basic

Rota para cancelar uma cobrança recorrente com Split por um valor total

## Path parameters

- `charge_id` string, required

## Request body

- object
  - `amount` integer: Valor a ser cancelado. Caso não seja informado, será considerado o valor total da cobrança.
  - `split` object[]: Lista de regras de split.
    - `amount` integer: Valor destinado ao recebedor.
    - `recipient_id` string: Código do recebedor. Formato: rp_XXXXXXXXXXXXXXXX.
    - `type` string: Tipo de divisão. Os valores possíveis são flat ou percentage.
    - `options` object: Informações da responsabilidade do recebedor na transação.
      - `charge_processing_fee` boolean: Indica se o recebedor vinculado à regra será cobrado pelas taxas da transação
      - `charge_remainder_fee` boolean: Indica se o recebedor vinculado à regra irá receber o restante dos recebíveis após uma divisão
      - `liable` boolean: Indica se o recebedor é responsável pela transação em caso de chargeback.
  - `bank_account` object: Dados da conta bancária do comprador. Somente utilizado para estorno de boleto, onde é um parâmetro obrigatório.
    - `holder_name` string, required: Nome do titular da conta.
    - `holder_type` string, required: Tipo de titular. Valores possíveis são **individual** (pessoa física) ou **company** (pessoa jurídica).
    - `holder_document` string, required: Número do documento do titular da conta. Deve ser igual ao documento do recebedor.
    - `bank` string, required: Código do banco.
    - `branch_number` string, required: Número da agência.
    - `branch_check_digit` string: Código verificador da agência.
    - `account_number` string, required: Número da conta. Máximo 13 caracteres numéricos.
    - `account_check_digit` string, required: Código verificador da conta.
    - `type` string, required: Tipo da conta. Valores possíveis são **checking** (conta corrente) ou **savings** (conta poupança).

## Response `200`

200

- object
  - `id` string
  - `code` string
  - `gateway_id` string
  - `amount` integer
  - `paid_amount` integer
  - `canceled_amount` integer
  - `status` string
  - `currency` string
  - `payment_method` string
  - `paid_at` string
  - `canceled_at` string
  - `created_at` string
  - `updated_at` string
  - `order` object
    - `id` string
    - `code` string
    - `amount` integer
    - `closed` boolean
    - `created_at` string
    - `updated_at` string
    - `closed_at` string
    - `currency` string
    - `status` string
    - `customer_id` string
  - `customer` object
    - `id` string
    - `name` string
    - `email` string
    - `document` string
    - `type` string
    - `delinquent` boolean
    - `address` object
      - `id` string
      - `line_1` string
      - `line_2` string
      - `street` string
      - `number` string
      - `complement` string
      - `zip_code` string
      - `neighborhood` string
      - `city` string
      - `state` string
      - `country` string
      - `status` string
      - `created_at` string
      - `updated_at` string
    - `created_at` string
    - `updated_at` string
    - `phones` object
      - `home_phone` object
        - `country_code` string
        - `number` string
        - `area_code` string
      - `mobile_phone` object
        - `country_code` string
        - `number` string
        - `area_code` string
    - `metadata` object
      - `company` string
  - `last_transaction` object
    - `id` string
    - `transaction_type` string
    - `gateway_id` string
    - `amount` integer
    - `status` string
    - `success` boolean
    - `installments` integer
    - `statement_descriptor` string
    - `acquirer_name` string
    - `acquirer_tid` string
    - `acquirer_nsu` string
    - `acquirer_return_code` string
    - `operation_type` string
    - `card` object
      - `id` string
      - `first_six_digits` string
      - `last_four_digits` string
      - `brand` string
      - `holder_name` string
      - `exp_month` integer
      - `exp_year` integer
      - `status` string
      - `type` string
      - `created_at` string
      - `updated_at` string
      - `billing_address` object
        - `street` string
        - `number` string
        - `zip_code` string
        - `neighborhood` string
        - `city` string
        - `state` string
        - `country` string
        - `line_1` string
    - `created_at` string
    - `updated_at` string
    - `gateway_response` object
      - `code` string
      - `errors` object[]
    - `antifraud_response` object
    - `split` object[]
      - `id` string
      - `type` string
      - `gateway_id` string
      - `amount` integer
      - `recipient` object
        - `id` string
        - `name` string
        - `email` string
        - `document` string
        - `description` string
        - `type` string
        - `status` string
        - `created_at` string
        - `updated_at` string
      - `options` object
        - `liable` boolean
        - `charge_processing_fee` boolean
        - `charge_remainder_fee` boolean
    - `metadata` object

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ef323290c0ff`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pagar/apis/pagarme-api/changes/charges/:charge_id%20/delete.md)

---

[API](https://skmtc.dev/pagar/apis/pagarme-api.md) - [All operations](https://skmtc.dev/pagar/apis/pagarme-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pagar/apis/pagarme-api/revisions/ef323290c0ff?raw)