---
title: "Criar recebedor"
url: "https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5/operations/criar-recebedor-1"
---

> Full API specification: https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5.md

# Criar recebedor

`POST` `/recipients`

Operation ID: `criar-recebedor-1`

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

Content types: `application/json`

## Responses

- `200` - 200
- `400` - 400

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Pagar.me v5 API (Legado)
  version: 5.0.0
servers:
  - url: https://api.stone.com.br/core/v5
paths:
  /recipients:
    post:
      summary: Criar recebedor
      description: 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.
      operationId: criar-recebedor-1
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - register_information
                - default_bank_account
              properties:
                code:
                  type: string
                  description: Referencia externa única por recebedor
                register_information:
                  type: object
                  description: 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].
                  required:
                    - email
                    - document
                    - type
                    - company_name
                    - trading_name
                    - annual_revenue
                    - name
                    - birthdate
                    - monthly_income
                    - professional_occupation
                  properties:
                    email:
                      type: string
                      description: "[PF/PJ] E-mail do recebedor."
                    document:
                      type: string
                      description: "[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:
                      type: string
                      description: "[PF/PJ] Para recebedores Pessoa Física, utilizar 'individual' e
                        para recebedores Pessoa Jurídica, utilizar
                        'corporation'."
                    site_url:
                      type: string
                      description: "[PF/PJ] Site do recebedor. Observação: É necessário incluir o
                        protocolo Http ou Https."
                    phone_numbers:
                      type: object
                      description: "[PJ] Telefone do recebedor."
                      required:
                        - ddd
                        - number
                      properties:
                        ddd:
                          type: string
                          description: DDD (Discagem Direta à Distância)
                        number:
                          type: string
                          description: Número do telefone
                        type:
                          type: string
                          description: Tipo do telefone
                    company_name:
                      type: string
                      description: "[PJ] Nome fantasia do recebedor. Campo exclusivo para recebedores
                        Pessoa Jurídica."
                    trading_name:
                      type: string
                      description: "[PJ] Razão social da empresa. Campo exclusivo para recebedores
                        Pessoa Jurídica."
                    annual_revenue:
                      type: integer
                      description: "[PJ] Receita anual da empresa. Campo exclusivo para recebedores
                        Pessoa Jurídica."
                      format: int32
                    corporation_type:
                      type: string
                      description: "[PJ] Tipo da empresa. Campo exclusivo para recebedores Pessoa
                        Jurídica."
                    founding_date:
                      type: string
                      description: "[PJ] Data de fundação da empresa. Campo exclusivo para recebedores
                        Pessoa Jurídica."
                    main_address:
                      type: object
                      description: "[PJ] Endereço da empresa. Campo exclusivo para recebedores Pessoa
                        Jurídica."
                      required:
                        - street
                        - complementary
                        - street_number
                        - neighborhood
                        - city
                        - state
                        - zip_code
                        - reference_point
                      properties:
                        street:
                          type: string
                          description: Rua
                        complementary:
                          type: string
                          description: Complemento
                        street_number:
                          type: string
                          description: Número
                        neighborhood:
                          type: string
                          description: Bairro
                        city:
                          type: string
                          description: Cidade
                        state:
                          type: string
                          description: Estado
                        zip_code:
                          type: string
                          description: CEP. Para endereço brasileiro, deve conter uma numeração de 8
                            dígitos
                        reference_point:
                          type: string
                          description: Ponto de referência do endereço
                    managing_partners:
                      type: array
                      description: "[PJ] Representante legal atrelado a empresa. Campo exclusivo para
                        recebedores Pessoa Jurídica."
                      items:
                        properties:
                          name:
                            type: string
                            description: Nome do representante legal atrelado a empresa representada pelo
                              recebedor
                          email:
                            type: string
                            description: E-mail do representante legal atrelado a empresa representada pelo
                              recebedor
                          document:
                            type: string
                            description: Número do CPF do representante legal atrelado a empresa
                              representada pelo recebedor
                          type:
                            type: string
                            description: Sempre será 'individual'
                          mother_name:
                            type: string
                            description: Nome da mãe do representante legal atrelado a empresa representada
                              pelo recebedor
                          birthdate:
                            type: string
                            description: Aniversário do representante legal atrelado a empresa representada
                              pelo recebedor
                          monthly_income:
                            type: string
                            description: "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:
                            type: string
                            description: Ocupação profissional do representante legal atrelado a empresa
                              representada pelo recebedor
                          self_declared_legal_representative:
                            type: boolean
                            description: Garantia de que aquele cadastro de pessoal física se identifica
                              como representante legal do CNPJ do recebedor ao
                              qual está atrelado
                          address:
                            type: object
                            required:
                              - street
                              - complementary
                              - street_number
                              - neighborhood
                              - city
                              - state
                              - zip_code
                              - reference_point
                            properties:
                              street:
                                type: string
                                description: Rua
                              complementary:
                                type: string
                                description: Complemento
                              street_number:
                                type: string
                                description: Número
                              neighborhood:
                                type: string
                                description: Bairro
                              city:
                                type: string
                                description: Cidade
                              state:
                                type: string
                                description: Estado
                              zip_code:
                                type: string
                                description: CEP. Para endereço brasileiro, deve conter uma numeração de 8
                                  dígitos
                              reference_point:
                                type: string
                                description: Ponto de referência do endereço
                          phone_numbers:
                            type: array
                            items:
                              properties:
                                ddd:
                                  type: string
                                  description: DDD (Discagem Direta à Distância)
                                number:
                                  type: string
                                  description: Número do telefone
                                type:
                                  type: string
                                  description: Tipo do telefone
                              required:
                                - ddd
                                - number
                              type: object
                        required:
                          - name
                          - email
                          - document
                          - birthdate
                          - monthly_income
                          - professional_occupation
                          - self_declared_legal_representative
                        type: object
                    name:
                      type: string
                      description: "[PF] Nome do recebedor. Campo exclusivo para recebedores Pessoa
                        Física."
                    mother_name:
                      type: string
                      description: "[PF] Nome da mãe. Campo exclusivo para recebedores Pessoa Física."
                    birthdate:
                      type: string
                      description: "[PF] Aniversário. Campo exclusivo para recebedores Pessoa Física."
                    monthly_income:
                      type: integer
                      description: "[PF] Renda mensal. Campo exclusivo para recebedores Pessoa
                        Física."
                      format: int32
                    professional_occupation:
                      type: string
                      description: "[PF] Ocupação profissional. Campo exclusivo para recebedores
                        Pessoa Física."
                    address:
                      type: object
                      description: "[PF] Endereço do recebedor."
                      required:
                        - street
                        - complementary
                        - street_number
                        - neighborhood
                        - city
                        - state
                        - zip_code
                        - reference_point
                      properties:
                        street:
                          type: string
                          description: Rua
                        complementary:
                          type: string
                          description: Complemento
                        street_number:
                          type: string
                          description: Número
                        neighborhood:
                          type: string
                          description: Bairro
                        city:
                          type: string
                          description: Cidade
                        state:
                          type: string
                          description: Estado
                        zip_code:
                          type: string
                          description: CEP. Para endereço brasileiro, deve conter uma numeração de 8
                            dígitos
                        reference_point:
                          type: string
                          description: Ponto de referência do endereço
                default_bank_account:
                  type: object
                  description: Dados da conta bancária do recebedor.
                  required:
                    - holder_name
                    - holder_type
                    - holder_document
                    - bank
                    - branch_number
                    - account_number
                    - account_check_digit
                    - type
                  properties:
                    holder_name:
                      type: string
                      description: Nome do titular da conta.
                    holder_type:
                      type: string
                      description: Tipo de titular. Valores possíveis são **individual** (pessoa
                        física) ou **company** (pessoa jurídica).
                    holder_document:
                      type: string
                      description: Número do documento do titular da conta. Deve ser igual ao
                        documento do recebedor.
                    bank:
                      type: string
                      description: Código do banco.
                    branch_number:
                      type: string
                      description: Número da agência.
                    branch_check_digit:
                      type: string
                      description: Código verificador da agência.
                    account_number:
                      type: string
                      description: Número da conta. Máximo 13 caracteres numéricos
                    account_check_digit:
                      type: string
                      description: Código verificador da conta.
                    type:
                      type: string
                      description: Tipo da conta. Valores possíveis são **checking** ou **savings**.
                    metadata:
                      type: object
                      description: Objeto chave/valor utilizado para armazenar informações adicionais
                        sobre a conta bancária.
                      properties: {}
                transfer_settings:
                  type: object
                  description: Informações de transferência do recebedor
                  properties:
                    transfer_enabled:
                      type: boolean
                      description: _Indica se o recebedor receberá seus pagamentos automaticamente `.
                    transfer_interval:
                      type: string
                      description: Indica a frequência das transferências automáticas para a conta do
                        recebedor.
                    transfer_day:
                      type: integer
                      description: Indica o dia em que ocorrerá as transferências automáticas.
                      format: int32
                automatic_anticipation_settings:
                  type: object
                  description: Informações de antecipação automática do recebedor
                  properties:
                    enabled:
                      type: boolean
                      description: Indica se o recebedor receberá antecipações automaticamente
                    type:
                      type: string
                      description: ndica o tipo de antecipação automática que será configurado para a
                        conta do recebedor. Valores possíveis **full** e
                        **1025**.
                    volume_percentage:
                      type: string
                      description: Indica o volume passível de ser antecipado para o recebedor.
                    days:
                      type: array
                      description: Indica os dias em que ocorrerá as antecipações automáticas.
                      items:
                        type: string
                    delay:
                      type: string
                      description: 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:
                  type: string
                  description: Objeto chave/valor utilizado para armazenar informações adicionais
                    sobre o recebedor.
            examples:
              Request Pessoa Jurídica:
                value:
                  code: "1234"
                  register_information:
                    company_name: Recebedor pessoa juridica
                    trading_name: Empresa LTDA
                    email: empresax@avengers.com
                    document: "77699131000133"
                    type: corporation
                    site_url: http://www.site.com
                    annual_revenue: 1000000
                    corporation_type: LTDA
                    founding_date: 2010-10-30
                    main_address:
                      street: Av. General Justo
                      complementary: Bloco A
                      street_number: "375"
                      neighborhood: Centro
                      city: Rio de Janeiro
                      state: RJ
                      zip_code: "20021130"
                      reference_point: Ao lado da banca de jornal
                    phone_numbers:
                      - ddd: "21"
                        number: "994647568"
                        type: mobile
                    managing_partners:
                      - name: Tony Stark
                        email: tstark@avengers.com
                        document: "26224451990"
                        type: individual
                        mother_name: Nome da mae
                        birthdate: 12/10/1995
                        monthly_income: 120000
                        professional_occupation: Vendedor
                        self_declared_legal_representative: true
                        address:
                          street: Av. General Justo
                          complementary: Bloco A
                          street_number: "375"
                          neighborhood: Centro
                          city: Rio de Janeiro
                          state: RJ
                          zip_code: "20021130"
                          reference_point: Ao lado da banca de jornal
                        phone_numbers:
                          - ddd: "27"
                            number: "999992628"
                            type: mobile
                  transfer_settings:
                    transfer_enabled: "false"
                    transfer_interval: Daily
                    transfer_day: 0
                  default_bank_account:
                    holder_name: Tony Stark
                    holder_type: individual
                    holder_document: "26224451990"
                    bank: "341"
                    branch_number: "1234"
                    branch_check_digit: "6"
                    account_number: "12345"
                    account_check_digit: "6"
                    type: checking
                  automatic_anticipation_settings:
                    enabled: "true"
                    type: full
                    volume_percentage: "50"
                    delay: "null"
              Request Pessoa Física:
                value:
                  code: "1234"
                  register_information:
                    name: Recebedor Pessoa fisica
                    email: tstark@avengers.com
                    document: "26224451990"
                    type: individual
                    site_url: https://sitedorecebedor.com.br
                    mother_name: Nome da mae
                    birthdate: 12/10/1995
                    monthly_income: 120000
                    professional_occupation: Vendedor
                    address:
                      street: Av. General Justo
                      complementary: Bloco A
                      street_number: "375"
                      neighborhood: Centro
                      city: Rio de Janeiro
                      state: RJ
                      zip_code: "20021130"
                      reference_point: Ao lado da banca de jornal
                    phone_numbers:
                      - ddd: "21"
                        number: "994647568"
                        type: mobile
                  transfer_settings:
                    transfer_enabled: "false"
                    transfer_interval: Daily
                    transfer_day: 0
                  default_bank_account:
                    holder_name: Tony Stark
                    holder_type: individual
                    holder_document: "26224451990"
                    bank: "341"
                    branch_number: "1234"
                    branch_check_digit: "6"
                    account_number: "12345"
                    account_check_digit: "6"
                    type: checking
                  automatic_anticipation_settings:
                    enabled: "true"
                    type: full
                    volume_percentage: "50"
                    delay: "null"
      responses:
        "200":
          description: "200"
          content:
            application/json:
              examples:
                Result:
                  value: >-
                    {
                        "id": "re_clxnqkxk709sc019taqhmj4kf",
                        "name": "Antonio da Silva",
                        "email": "tstark@avengers.com",
                        "code": "21875b51-d4c3-46d3-aeee-d8b3112aab55",
                        "document": "26224451990",
                        "type": "individual",
                        "payment_mode": "bank_transfer",
                        "status": "active",
                        "created_at": "2024-06-20T20:50:31Z",
                        "updated_at": "2024-06-20T20:50:31Z",
                        "transfer_settings": {
                            "transfer_enabled": true,
                            "transfer_interval": "Weekly",
                            "transfer_day": 1
                        },
                        "default_bank_account": {
                            "id": "ba_LlpvMnqcXSO2EVW8",
                            "holder_name": "Tony Stark",
                            "holder_type": "individual",
                            "holder_document": "26224451990",
                            "bank": "341",
                            "branch_number": "1234",
                            "branch_check_digit": "6",
                            "account_number": "12345",
                            "account_check_digit": "6",
                            "type": "checking",
                            "status": "active",
                            "created_at": "2024-06-20T20:50:31Z",
                            "updated_at": "2024-06-20T20:50:31Z",
                            "metadata": {
                                "key": "value"
                            }
                        },
                        "gateway_recipients": [
                            {
                                "gateway": "pagarme",
                                "status": "active",
                                "pgid": "re_clxnqkxk709sc019taqhmj4kf",
                                "createdAt": "2024-06-20T20:50:31Z",
                                "updatedAt": "2024-06-20T20:50:31Z"
                            }
                        ],
                        "automatic_anticipation_settings": {
                            "enabled": false,
                            "type": "full",
                            "volume_percentage": 0,
                            "delay": 365
                        },
                        "metadata": {
                            "key": "value"
                        },
                        "register_information": {
                            "email": "tstark@avengers.com",
                            "document": "26224451990",
                            "type": "individual",
                            "site_url": "http://www.site.com",
                            "phone_numbers": [
                                {
                                    "ddd": "77",
                                    "number": "987655432",
                                    "type": "mobile"
                                }
                            ],
                            "name": "Antonio da Silva",
                            "mother_name": "Maria da Silva",
                            "birthdate": "02/10/1990",
                            "monthly_income": "3000",
                            "professional_occupation": "Professor",
                            "address": {
                                "street": "Rua Alberto Carvalho",
                                "complementary": "Apto. 345",
                                "street_number": "111",
                                "neighborhood": "Gomes Pereira",
                                "city": "Porto Seguro",
                                "state": "BA",
                                "zip_code": "44900000",
                                "reference_point": "Próximo ao Posto Quatro Rodas"
                            }
                        }
                    }
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: re_clxnqkxk709sc019taqhmj4kf
                  name:
                    type: string
                    example: Antonio da Silva
                  email:
                    type: string
                    example: tstark@avengers.com
                  code:
                    type: string
                    example: 21875b51-d4c3-46d3-aeee-d8b3112aab55
                  document:
                    type: string
                    example: "26224451990"
                  type:
                    type: string
                    example: individual
                  payment_mode:
                    type: string
                    example: bank_transfer
                  status:
                    type: string
                    example: active
                  created_at:
                    type: string
                    example: 2024-06-20T20:50:31Z
                  updated_at:
                    type: string
                    example: 2024-06-20T20:50:31Z
                  transfer_settings:
                    type: object
                    properties:
                      transfer_enabled:
                        type: boolean
                        example: true
                        default: true
                      transfer_interval:
                        type: string
                        example: Weekly
                      transfer_day:
                        type: integer
                        example: 1
                        default: 0
                  default_bank_account:
                    type: object
                    properties:
                      id:
                        type: string
                        example: ba_LlpvMnqcXSO2EVW8
                      holder_name:
                        type: string
                        example: Tony Stark
                      holder_type:
                        type: string
                        example: individual
                      holder_document:
                        type: string
                        example: "26224451990"
                      bank:
                        type: string
                        example: "341"
                      branch_number:
                        type: string
                        example: "1234"
                      branch_check_digit:
                        type: string
                        example: "6"
                      account_number:
                        type: string
                        example: "12345"
                      account_check_digit:
                        type: string
                        example: "6"
                      type:
                        type: string
                        example: checking
                      status:
                        type: string
                        example: active
                      created_at:
                        type: string
                        example: 2024-06-20T20:50:31Z
                      updated_at:
                        type: string
                        example: 2024-06-20T20:50:31Z
                      metadata:
                        type: object
                        properties:
                          key:
                            type: string
                            example: value
                  gateway_recipients:
                    type: array
                    items:
                      type: object
                      properties:
                        gateway:
                          type: string
                          example: pagarme
                        status:
                          type: string
                          example: active
                        pgid:
                          type: string
                          example: re_clxnqkxk709sc019taqhmj4kf
                        createdAt:
                          type: string
                          example: 2024-06-20T20:50:31Z
                        updatedAt:
                          type: string
                          example: 2024-06-20T20:50:31Z
                  automatic_anticipation_settings:
                    type: object
                    properties:
                      enabled:
                        type: boolean
                        example: false
                        default: true
                      type:
                        type: string
                        example: full
                      volume_percentage:
                        type: integer
                        example: 0
                        default: 0
                      delay:
                        type: integer
                        example: 365
                        default: 0
                  metadata:
                    type: object
                    properties:
                      key:
                        type: string
                        example: value
                  register_information:
                    type: object
                    properties:
                      email:
                        type: string
                        example: tstark@avengers.com
                      document:
                        type: string
                        example: "26224451990"
                      type:
                        type: string
                        example: individual
                      site_url:
                        type: string
                        example: http://www.site.com
                      phone_numbers:
                        type: array
                        items:
                          type: object
                          properties:
                            ddd:
                              type: string
                              example: "77"
                            number:
                              type: string
                              example: "987655432"
                            type:
                              type: string
                              example: mobile
                      name:
                        type: string
                        example: Antonio da Silva
                      mother_name:
                        type: string
                        example: Maria da Silva
                      birthdate:
                        type: string
                        example: 02/10/1990
                      monthly_income:
                        type: string
                        example: "3000"
                      professional_occupation:
                        type: string
                        example: Professor
                      address:
                        type: object
                        properties:
                          street:
                            type: string
                            example: Rua Alberto Carvalho
                          complementary:
                            type: string
                            example: Apto. 345
                          street_number:
                            type: string
                            example: "111"
                          neighborhood:
                            type: string
                            example: Gomes Pereira
                          city:
                            type: string
                            example: Porto Seguro
                          state:
                            type: string
                            example: BA
                          zip_code:
                            type: string
                            example: "44900000"
                          reference_point:
                            type: string
                            example: Próximo ao Posto Quatro Rodas
        "400":
          description: "400"
          content:
            application/json:
              examples:
                Result:
                  value: "{}"
              schema:
                type: object
                properties: {}
      deprecated: false
security:
  - sec0: []
components:
  securitySchemes:
    sec0:
      type: http
      scheme: basic
```