---
title: "Incluir cobrança no pedido"
method: POST
path: "/charges"
---

# Incluir cobrança no pedido

`POST /charges`

Enquanto um pedido estiver **aberto**, é possível adicionar novas cobranças utilizando o `order_id` na criação de uma cobrança.

## Request body

- object
  - `order_id` string, required — Código do pedido
  - `amount` integer, required — Valor da cobrança em centavos
  - `payment` object, required — Dados sobre pagamento.
    - `payment_method` string — Meio de pagamento. Valores possíveis: credit_card, boleto, voucher, bank_transfer, safety_pay, cash, pix
    - `credit_card` object — Dados sobre o pagamento com cartão de crédito (obrigatório caso o payment_method seja credit_card)
      - `operation_type` string — Indica se a transação deve ser capturada "auth_and_capture", autorizada "auth_only", ou pré autorizada "pre_auth".
      - `installments` integer — Quantidade de parcelas. Se a transação for uma recorrência, o número de parcelas deverá ser 1.
      - `statement_descriptor` string — Texto exibido na fatura do cartão. Max: 22 caracteres para clientes Gateway; 13 para clientes PSP
      - `card` object — Cartão de crédito.
        - `number` string, required — Número do cartão. Entre 13 e 19 caracteres
        - `holder_name` string, required — Nome do portador como está impresso no cartão. Máximo de 64 caracteres (Caracteres especiais e números não são aceitos)
        - `holder_document` string — CPF ou CNPJ do portador do cartão. Obrigatório caso o tipo do cartão seja voucher (bandeiras VR ou Pluxee).
        - `exp_month` integer, required — Mês de validade do cartão. Valor entre 1 e 12 (inclusive)
        - `exp_year` integer, required — Ano de validade do cartão. Formatos yy ou yyyy. Ex: 23 ou 2023.
        - `cvv` string — Código de segurança do cartão. O campo aceita 4 ou 3 caracteres, variando por bandeira.
        - `brand` string — (Opcional) Bandeira do cartão. Para cartões de crédito, temos como valores possíveis: Elo, Mastercard, Visa, Amex, ou Hipercard. Para voucher, temos como valores possíveis: Alelo, Ticket, VR ou Pluxee.
        - `label` string — Indica a label do cartão
        - `billing_address_id` string — Código do endereço de cobrança. Max: 36 caracteres.<>Opcional, pode ser utilizado no lugar do billing_address.
        - `billing_address` object
          - `line_1` string — Linha 1 do endereço. (Número, Rua, e Bairro - Nesta ordem e separados por vírgula) Max: 256 caracteres.
          - `line_2` string — Linha 2 do endereço. (Complemento - Andar, Sala, Apto). Max: 128 caracteres.
          - `zip_code` string — CEP. Max: 16 caracteres.
          - `city` string — Cidade. Max: 64 caracteres.
          - `state` string — Código do estado no formato ISO 3166-2.
          - `country` string — Código do país no formato ISO 3166-1 alpha-2.
      - `network_token` object — Token de bandeira.
        - `number` string — Número do Network Token. Entre 13 e 19 caracteres. Ex: 4190000000000069
        - `holder_name` string — Nome do portador como está impresso no cartão. Máximo de 64 caracteres (Caracteres especiais e números não são aceitos)
        - `exp_month` integer — Mês de validade do Network Token. Valor entre 1 e 12 (inclusive)
        - `exp_year` integer — Ano de validade do Network Token. Formatos yy ou yyyy. Ex: 23 ou 2023.
        - `cryptograms` string — Criptograma de autenticação para Network Token. Pode enviar mais de um, caso queira em uma lista de strings. Formato em base64. Ex: ANfQt43bddROAAEnSAMhAAADFA====
      - `card_id` string — identificador do cartão de um cliente.
      - `card_token` string — token do cartão gerado pelo checkout transparente
      - `recurrence_cycle` string — Informa se o pedido é referente a uma recorrência externa. Possíveis valores: `first` ou `subsequent`.
      - `initiated_type` string — Identificador do tipo de transação avulsa. Valores possíveis: `partial_shipment` (Remessa Parcial), `related_or_delayed_charge` (Cobrança Atrasada), `no_show` (Multa) ou `retry` (Retentativa). Valores possíveis: `standing_order` (Ordem Permanente), `instalment` (Parcelamento) ou `subscription` (Assinatura convencional com valor e frequência fixa). [Mais detalhes](https://docs.pagar.me/page/mitcit-transa%C3%A7%C3%B5es-card-on-file-mastercard).
      - `recurrence_model` string — Identificador do tipo de recorrência. Valores possíveis: `standing_order` (Ordem Permanente), `instalment` (Parcelamento) ou `subscription` (Assinatura convencional com valor e frequência fixa). Valores possíveis: `standing_order` (Ordem Permanente), `instalment` (Parcelamento) ou `subscription` (Assinatura convencional com valor e frequência fixa). [Mais detalhes](https://docs.pagar.me/page/mitcit-transa%C3%A7%C3%B5es-card-on-file-mastercard).
      - `payment_origin` object — Identificador da primeira cobrança de uma recorrência. [Mais detalhes](https://docs.pagar.me/docs/api-v5-identificador-de-recorr%C3%AAncia-para-assinaturas-externas).
        - `charge_id` string — Identificador da cobrança
        - `brand_id` string — Identificador da bandeira
    - `voucher` object — Dados sobre o pagamento com voucher (obrigatório caso o payment_method seja voucher)
      - `statement_descriptor` string — Texto exibido na fatura do cartão. Max: 22 caracteres.
      - `card` object — Cartão voucher.
        - `number` string, required — Número do cartão. Entre 13 e 19 caracteres
        - `holder_name` string, required — Nome do portador como está impresso no cartão. Máximo de 64 caracteres (Caracteres especiais e números não são aceitos)
        - `holder_document` string — CPF ou CNPJ do portador do cartão. Obrigatório caso o tipo do cartão seja voucher (bandeiras VR ou Pluxee).
        - `exp_month` integer, required — Mês de validade do cartão. Valor entre 1 e 12 (inclusive)
        - `exp_year` integer, required — Ano de validade do cartão. Formatos yy ou yyyy. Ex: 23 ou 2023.
        - `cvv` string — Código de segurança do cartão. O campo aceita 4 ou 3 caracteres, variando por bandeira.
        - `brand` string — (Opcional) Bandeira do cartão. Para cartões de crédito, temos como valores possíveis: Elo, Mastercard, Visa, Amex, ou Hipercard. Para voucher, temos como valores possíveis: Alelo, Ticket, VR ou Pluxee.
        - `label` string — Indica a label do cartão
        - `billing_address_id` string — Código do endereço de cobrança. Max: 36 caracteres.<>Opcional, pode ser utilizado no lugar do billing_address.
        - `billing_address` object
          - `line_1` string — Linha 1 do endereço. (Número, Rua, e Bairro - Nesta ordem e separados por vírgula) Max: 256 caracteres.
          - `line_2` string — Linha 2 do endereço. (Complemento - Andar, Sala, Apto). Max: 128 caracteres.
          - `zip_code` string — CEP. Max: 16 caracteres.
          - `city` string — Cidade. Max: 64 caracteres.
          - `state` string — Código do estado no formato ISO 3166-2.
          - `country` string — Código do país no formato ISO 3166-1 alpha-2.
      - `card_id` string — identificador do cartão de um cliente
      - `card_token` string — token do cartão gerado pelo checkout transparente
      - `card.holder_document` string — Número do documento do portador do cartão. Este campo deverá ser enviado dentro do objeto card e é obrigatório para voucher.
    - `boleto` object — Dados sobre o pagamento com boleto (obrigatório caso o payment_method seja boleto).
      - `bank` string — Código do banco. 001 (Banco do Brasil); 033 (Santander); 237 (Bradesco); 341 (Itau); 745 (Citibank) e 104 (Caixa Econômica Federal).
      - `instructions` string — Instruções do boleto. Max: 256 caracteres.
      - `due_at` string — Data de vencimento. (Opcional)
      - `nosso_numero` string — Número que identifica unicamente um boleto para uma conta.
      - `type` string — Tipo de espécie do boleto.DM (Duplicata Mercantil) e BDP (Boleto de proposta)
      - `document_number` string — Identificador do boleto. Max: 16 caracteres.
      - `interest` object — Aplicação do juros sobre o boleto.
        - `days` integer, required — Dias após a expiração do boleto quando o juros deve ser cobrado.
        - `type` string, required — Tipo de divisão. Os valores possíveis são flat ou percentage.
        - `amount` string, required — Valor em porcentagem ou em centavos da taxa de juros que será cobrada ao mês.
      - `fine` object — Aplicação da multa sobre o boleto.
        - `days` integer, required — Dias após a expiração do boleto quando a multa deve ser cobrada.
        - `type` string, required — Tipo de divisão. Os valores possíveis são flat ou percentage.
        - `amount` integer, required — Valor em porcentagem ou em centavos que será cobrada na multa.
      - `discount` object — Objeto raiz de desconto por antecipação. Exclusivo PSP.
        - `type` string — Tipo do desconto: "percentage" (% sobre o total) ou "flat" (centavos). Aplica-se a todas as regras do array.
        - `rules` object[] — Lista de regras de desconto ordenadas por limit_date crescente.
          - `limit_date` string — Data limite da regra. Formato YYYY-MM-DD. Deve ser anterior ao due_at do boleto.
          - `amount` integer — Valor do desconto. Se type: percentage: entre 0.01 e 100 (ex: 15.00 = 15%). Se type: flat: inteiro em centavos, mín. 1 (ex: 500 = R$5,00).
    - `bank_transfer` object — Dados sobre o pagamento com transferência entre contas bancárias. (obrigatório caso o payment_method seja bank_transfer)
      - `bank` string — Código do Banco. 001 (Banco do Brasil); 237 (Bradesco) e 341 (Itau).
    - `Pix` object — Dados sobre o pagamento com pix (obrigatório caso o payment_method seja pix)
      - `expires_in` integer — Data de expiração do Pix em segundos.
      - `expires_at` string, date — Data de expiração do Pix. (Opcional | Mandatório caso não enviado o expires_in) [Formato: YYYY-MM-DDThh:mm:ss] UTC
      - `additional_information` object — Objeto chave/valor utilizado para adicionar informações sobre o pagamento. Esses dados serão visíveis para o consumidor na hora do pagamento.
        - `Name` string — Nome utilizado para adicionar informações sobre o pagamento.
        - `Value` string — Valor utilizado para adicionar informações sobre o pagamento.
    - `amount` integer — Valor da cobrança em centavos
    - `split` object[]
      - `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.
    - `cash` object — Dados sobre o pagamento com cash(obrigatório caso o payment_method seja cash).
      - `description` string — Descrição do pagamento. Max: 256 caracteres.
      - `confirm` boolean — Indica se o pagamento será confirmado no ato da criação da cobrança ou se deve ser confirmado posteriormente.
      - string
  - `due_at` string, date — Data de vencimento da cobrança.
  - `customer_id` string — Código do cliente.
  - `customer` object — Dados do cliente. Se nem o **customer_id** nem o **customer** forem informados, será considerado o mesmo cliente do pedido.
  - `metadata` string — Objeto chave/valor utilizado para armazenar informações adicionais sobre a cobrança.

## Response `200`

200

- object
  - `id` string
  - `code` string
  - `gateway_id` string
  - `amount` integer
  - `status` string
  - `currency` string
  - `payment_method` string
  - `due_at` string
  - `paid_at` string
  - `created_at` string
  - `updated_at` string
  - `order` object
    - `id` string
    - `code` string
    - `amount` integer
    - `currency` string
    - `closed` boolean
    - `status` string
    - `created_at` string
    - `updated_at` string
  - `customer` object
    - `id` string
    - `name` string
    - `email` string
    - `delinquent` boolean
    - `created_at` string
    - `updated_at` string
  - `last_transaction` object
    - `id` string
    - `transaction_type` string
    - `funding_source` string
    - `gateway_id` string
    - `amount` integer
    - `status` string
    - `success` boolean
    - `installments` integer
    - `statement_descriptor` string
    - `acquirer_name` string
    - `acquirer_affiliation_code` string
    - `acquirer_tid` string
    - `acquirer_nsu` string
    - `acquirer_auth_code` string
    - `acquirer_message` string
    - `acquirer_return_code` string
    - `operation_type` string
    - `credit_card` object
      - `id` string
      - `last_four_digits` string
      - `brand` string
      - `holder_name` string
      - `exp_month` integer
      - `exp_year` integer
      - `status` string
      - `created_at` string
      - `updated_at` string
      - `billing_address` object
        - `zip_code` string
        - `city` string
        - `state` string
        - `country` string
        - `line_1` string
    - `created_at` string
    - `updated_at` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/pagar/apis/pagarme-api.md) · [All operations](https://skmtc.net/pagar/apis/pagarme-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pagar/pagarme-api/versions/dababf062743/schema)