---
title: "Criar recebedor"
method: POST
path: "/recipients"
---

# Criar recebedor

`POST /recipients`

Rota para criar um recebedor, definindo os dados do recebedor, transferência e qual a conta bancária que será utilizada para envio dos pagamentos.

## Request body

- object
  - `code` string — Referencia externa única por recebedor
  - `register_information` object, required — Dados cadastrais do recebedor. O objeto deve ser preenchido de acordo com o tipo do recebedor, Pessoa Física [PF] ou Pessoa Jurídica [PJ].
    - `email` string, required — [PF/PJ] E-mail do recebedor.
    - `document` string, required — [PF/PJ] Número do documento. Recebedores Pessoa Física preencherão o CPF e os recebedores Pessoa Jurídica preencherão o CNPJ.
    - `type` string, required — [PF/PJ] Para recebedores Pessoa Física, utilizar 'individual' e para recebedores Pessoa Jurídica, utilizar 'corporation'.
    - `site_url` string — [PF/PJ] Site do recebedor. Observação: É necessário incluir o protocolo Http ou Https.
    - `phone_numbers` object — [PJ] Telefone do recebedor.
      - `ddd` string, required — DDD (Discagem Direta à Distância)
      - `number` string, required — Número do telefone
      - `type` string — Tipo do telefone
    - `company_name` string, required — [PJ] Nome fantasia do recebedor. Campo exclusivo para recebedores Pessoa Jurídica.
    - `trading_name` string, required — [PJ] Razão social da empresa. Campo exclusivo para recebedores Pessoa Jurídica.
    - `annual_revenue` integer, required — [PJ] Receita anual da empresa. Campo exclusivo para recebedores Pessoa Jurídica.
    - `corporation_type` string — [PJ] Tipo da empresa. Campo exclusivo para recebedores Pessoa Jurídica.
    - `founding_date` string — [PJ] Data de fundação da empresa. Campo exclusivo para recebedores Pessoa Jurídica.
    - `main_address` object — [PJ] Endereço da empresa. Campo exclusivo para recebedores Pessoa Jurídica.
      - `street` string, required — Rua
      - `complementary` string, required — Complemento
      - `street_number` string, required — Número
      - `neighborhood` string, required — Bairro
      - `city` string, required — Cidade
      - `state` string, required — Estado
      - `zip_code` string, required — CEP. Para endereço brasileiro, deve conter uma numeração de 8 dígitos
      - `reference_point` string, required — Ponto de referência do endereço
    - `managing_partners` object[] — [PJ] Representante legal atrelado a empresa. Campo exclusivo para recebedores Pessoa Jurídica.
      - `name` string, required — Nome do representante legal atrelado a empresa representada pelo recebedor
      - `email` string, required — E-mail do representante legal atrelado a empresa representada pelo recebedor
      - `document` string, required — Número do CPF do representante legal atrelado a empresa representada pelo recebedor
      - `type` string — Sempre será 'individual'
      - `mother_name` string — Nome da mãe do representante legal atrelado a empresa representada pelo recebedor
      - `birthdate` string, required — Aniversário do representante legal atrelado a empresa representada pelo recebedor
      - `monthly_income` string, required — Renda mensal média ou estimada declarada pelo representante legal atrelado a empresa representada pelo recebedor. Exemplo: de R$1.000,00 até R$2.000,00
      - `professional_occupation` string, required — Ocupação profissional do representante legal atrelado a empresa representada pelo recebedor
      - `self_declared_legal_representative` boolean, required — Garantia de que aquele cadastro de pessoal física se identifica como representante legal do CNPJ do recebedor ao qual está atrelado
      - `address` object
        - `street` string, required — Rua
        - `complementary` string, required — Complemento
        - `street_number` string, required — Número
        - `neighborhood` string, required — Bairro
        - `city` string, required — Cidade
        - `state` string, required — Estado
        - `zip_code` string, required — CEP. Para endereço brasileiro, deve conter uma numeração de 8 dígitos
        - `reference_point` string, required — Ponto de referência do endereço
      - `phone_numbers` object[]
        - `ddd` string, required — DDD (Discagem Direta à Distância)
        - `number` string, required — Número do telefone
        - `type` string — Tipo do telefone
    - `name` string, required — [PF] Nome do recebedor. Campo exclusivo para recebedores Pessoa Física.
    - `mother_name` string — [PF] Nome da mãe. Campo exclusivo para recebedores Pessoa Física.
    - `birthdate` string, required — [PF] Aniversário. Campo exclusivo para recebedores Pessoa Física.
    - `monthly_income` integer, required — [PF] Renda mensal. Campo exclusivo para recebedores Pessoa Física.
    - `professional_occupation` string, required — [PF] Ocupação profissional. Campo exclusivo para recebedores Pessoa Física.
    - `address` object — [PF] Endereço do recebedor.
      - `street` string, required — Rua
      - `complementary` string, required — Complemento
      - `street_number` string, required — Número
      - `neighborhood` string, required — Bairro
      - `city` string, required — Cidade
      - `state` string, required — Estado
      - `zip_code` string, required — CEP. Para endereço brasileiro, deve conter uma numeração de 8 dígitos
      - `reference_point` string, required — Ponto de referência do endereço
  - `default_bank_account` object, required — Dados da conta bancária do recebedor.
    - `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** ou **savings**.
    - `metadata` object — Objeto chave/valor utilizado para armazenar informações adicionais sobre a conta bancária.
  - `transfer_settings` object — Informações de transferência do recebedor
    - `transfer_enabled` boolean — _Indica se o recebedor receberá seus pagamentos automaticamente `.
    - `transfer_interval` string — Indica a frequência das transferências automáticas para a conta do recebedor.
    - `transfer_day` integer — Indica o dia em que ocorrerá as transferências automáticas.
  - `automatic_anticipation_settings` object — Informações de antecipação automática do recebedor
    - `enabled` boolean — Indica se o recebedor receberá antecipações automaticamente
    - `type` string — ndica o tipo de antecipação automática que será configurado para a conta do recebedor. Valores possíveis **full** e **1025**.
    - `volume_percentage` string — Indica o volume passível de ser antecipado para o recebedor.
    - `days` string[] — Indica os dias em que ocorrerá as antecipações automáticas.
    - `delay` string — Indica a quantidade de dias que serão desconsiderados na contabilização do valor passível de ser antecipado. A contagem de dias é realizada a partir do dia da antecipação para trás
  - `metadata` string — Objeto chave/valor utilizado para armazenar informações adicionais sobre o recebedor.

## Response `200`

200

- object
  - `id` string
  - `name` string
  - `email` string
  - `code` string
  - `document` string
  - `type` string
  - `payment_mode` string
  - `status` string
  - `created_at` string
  - `updated_at` string
  - `transfer_settings` object
    - `transfer_enabled` boolean
    - `transfer_interval` string
    - `transfer_day` integer
  - `default_bank_account` object
    - `id` string
    - `holder_name` string
    - `holder_type` string
    - `holder_document` string
    - `bank` string
    - `branch_number` string
    - `branch_check_digit` string
    - `account_number` string
    - `account_check_digit` string
    - `type` string
    - `status` string
    - `created_at` string
    - `updated_at` string
    - `metadata` object
      - `key` string
  - `gateway_recipients` object[]
    - `gateway` string
    - `status` string
    - `pgid` string
    - `createdAt` string
    - `updatedAt` string
  - `automatic_anticipation_settings` object
    - `enabled` boolean
    - `type` string
    - `volume_percentage` integer
    - `delay` integer
  - `metadata` object
    - `key` string
  - `register_information` object
    - `email` string
    - `document` string
    - `type` string
    - `site_url` string
    - `phone_numbers` object[]
      - `ddd` string
      - `number` string
      - `type` string
    - `name` string
    - `mother_name` string
    - `birthdate` string
    - `monthly_income` string
    - `professional_occupation` string
    - `address` object
      - `street` string
      - `complementary` string
      - `street_number` string
      - `neighborhood` string
      - `city` string
      - `state` string
      - `zip_code` string
      - `reference_point` 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)