---
title: "Criar cobrança - PIX"
method: POST
path: "/charges"
---

# Criar cobrança - PIX

`POST /charges`

Este recurso permite a criação de um PIX cobrança.

## Request body

- object
  - `paymentMethod` string, required — Método de pagamento da cobrança.
  - `dueDate` string, date, required — Data de vencimento da cobrança.<br>Formato: <code>YYYY-MM-DD</code>.
  - `value` number, double, required — Valor da cobrança <code>precisão 2</code>.
  - `abatementValue` number, double — Valor do Abatimento. <code>precisão 2</code>.
  - `interestType` 'fixed_value' | 'percentage' — Tipo de juros aplicado a cobrança.<br>Valores permitidos <code>fixed_value</code> ou <code>percentage</code>.
  - `interestValue` number, double — Valor dos juros por mês. Valores inteiros ou decimais com <code>precisão 2</code>.
  - `applicableFine` number, double — Multa por atraso em valor percentual. <code>precisão 2</code>.
  - `clientControlNumber` string — Identificador próprio de uso da empresa.<br><code>Alfanumérico - 25 caracteres</code>
  - `expiresAfter` integer — Dias para baixa após o vencimento.
  - `discount` object — Desconto aplicado na cobrança.
    - `range` string, date — Data máxima do desconto
    - `discountType` 'fixed_value' | 'percentage' — Tipo do desconto. Valores possíveis: <b>fixed_value</b>, <b>percentage</b>
    - `discountValue` string — Valor do desconto.
  - `payer` object, required — Dados do pagador da cobrança.<br>Caso o pagador já esteja cadastrado, é possível enviar apenas o <code>documentNumber</code> que a API completará os demais dados
    - `name` string, required — Nome do pagador.
    - `email` string, required — E-mail do pagador.
    - `documentNumber` string, required — CPF ou CNPJ do pagador.
    - `address` object — Endereço do pagador. <b>Obrigatório</b>
      - `street` string, required — Rua do pagador.
      - `number` string, required — Número da residência do pagador.
      - `complement` string — Complemento do endereço do pagador.
      - `neighborhood` string, required — Bairro do pagador.
      - `city` string, required — Cidade do pagador.
      - `state` string, required — Estado do pagador.
      - `country` string — País do pagador
      - `zipCode` string, required — CEP do endereço do pagador.
    - `phone` object — Telefone do pagador.
      - `countryCode` string — Código de páis do telefone do pagador.
      - `areaCode` string — DDD do telefone do pagador.
      - `number` string — Número do telefone do pagador.
  - `receiptNumber` string — Número da nota fiscal vinculada a cobrança.
  - `grantor` object — Dados do Sacador / Avalista. *Obrigatório para abertura de protesto.*
    - `name` string, required — Nome do sacador / avalista.
    - `documentNumber` string, required — CPF ou CNPJ do sacador / avalista.
    - `address` object — Endereço do sacador / avalista.
      - `street` string, required — Rua do pagador.
      - `number` string, required — Número da residência do pagador.
      - `complement` string — Complemento do endereço do pagador.
      - `neighborhood` string, required — Bairro do pagador.
      - `city` string, required — Cidade do pagador.
      - `state` string, required — Estado do pagador.
      - `country` string — País do pagador
      - `zipCode` string, required — CEP do endereço do pagador.

## Response `200`

200

- object
  - `data` object
    - `id` string
    - `type` string
    - `attributes` object
      - `createdAt` string
      - `updatedAt` string
      - `status` string
      - `paymentMethod` string
      - `dueDate` string
      - `value` number
      - `discount` object
        - `range` string
        - `discountType` string
        - `discountValue` integer
      - `abatementValue` number
      - `interestType` string
      - `interestValue` integer
      - `applicableFine` integer
      - `payer` object
        - `data` object
          - `type` string
          - `attributes` object
            - `name` string
            - `documentNumber` string
            - `email` string
            - `address` object
              - …
            - `phone` object
              - …
      - `grantor` object
        - `data` object
          - `type` string
          - `attributes` object
            - `name` string
            - `documentNumber` string
            - `address` object
              - …
      - `fees` object
        - `data` object[]
          - `id` string
          - `type` string
          - `attributes` object
            - `kind` string
            - `value` integer
      - `payments` object
        - `data` object[]
      - `clientControlNumber` string
      - `origin` string
      - `receiptNumber` unknown
      - `expiresAfter` integer
      - `titleType` string
      - `pixData` object
        - `data` object
          - `id` string
          - `type` string
          - `attributes` object
            - `emv` string
            - `encodedImage` string

## Other responses

- `400` — 400
- `401` — 401
- `422` — 422

---

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