> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autorizou.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar Recebedor

> Cadastre destinatários para receber valores em operações de split de pagamento

Permite cadastrar destinatários (pessoas físicas ou jurídicas) que irão receber valores em splits de pagamento. Essencial para marketplaces e plataformas que precisam dividir pagamentos entre múltiplas partes.

<Note>
  **Comportamento Especial**: Se já existir um destinatário com o mesmo email
  para o seu merchant, a API retorna o destinatário existente com status `200`
  ao invés de criar um novo.
</Note>

## Parâmetros da Requisição

<ParamField body="external_reference" type="string" required>
  Identificador único do destinatário no seu sistema
</ParamField>

<ParamField body="email" type="string" required>
  Email válido para contato
</ParamField>

<ParamField body="legal_name" type="string" required>
  Nome legal ou razão social
</ParamField>

<ParamField body="trade_name" type="string" required>
  Nome fantasia ou comercial
</ParamField>

<ParamField body="status" type="string" required>
  Status do destinatário

  **Valores:** `approved`, `pending`, `blocked`, `reproved`
</ParamField>

<ParamField body="type" type="string" required>
  Tipo de pessoa

  **Valores:** `individual` (pessoa física), `company` (pessoa jurídica)
</ParamField>

<ParamField body="company_type" type="string" required>
  Tipo de empresa

  **Valores:** `MEI`, `ME`, `EPP`, `LTDA`, `EIRELI`, `SA`, `AUT`, `OTHER`
</ParamField>

<ParamField body="name" type="string">
  Nome completo (obrigatório quando `type = "individual"`)
</ParamField>

<ParamField body="birthday" type="date">
  Data de nascimento no formato `YYYY-MM-DD` (obrigatório quando `type =
      "individual"`)
</ParamField>

<ParamField body="founding_date" type="date">
  Data de fundação no formato `YYYY-MM-DD` (obrigatório quando `type =
      "company"`)
</ParamField>

### Documento

<ParamField body="document" type="object" required>
  <Expandable title="Dados do documento">
    <ParamField body="document.type" type="string" required>
      Tipo do documento

      **Valores:** `cpf`, `cnpj`
    </ParamField>

    <ParamField body="document.value" type="string" required>
      Número do documento (apenas dígitos, sem formatação)
    </ParamField>
  </Expandable>
</ParamField>

### Telefone

<ParamField body="phone" type="object" required>
  <Expandable title="Dados do telefone">
    <ParamField body="phone.type" type="string" required>
      Tipo do telefone

      **Valores:** `residential`, `mobile`, `commercial`, `public`
    </ParamField>

    <ParamField body="phone.ddi" type="string" required>
      Código DDI do país (ex: `"55"` para Brasil)
    </ParamField>

    <ParamField body="phone.ddd" type="string" required>
      Código de área DDD (ex: `"11"`)
    </ParamField>

    <ParamField body="phone.number" type="string" required>
      Número do telefone (apenas dígitos)
    </ParamField>
  </Expandable>
</ParamField>

### Endereço

<ParamField body="address" type="object" required>
  <Expandable title="Dados do endereço">
    <ParamField body="address.type" type="string" required>
      Tipo de endereço

      **Valores:** `billing` (cobrança), `shipping` (entrega)
    </ParamField>

    <ParamField body="address.line_1" type="string" required>
      Logradouro (rua/avenida)
    </ParamField>

    <ParamField body="address.number" type="string" required>
      Número do endereço
    </ParamField>

    <ParamField body="address.line_2" type="string">
      Complemento (opcional)
    </ParamField>

    <ParamField body="address.neighborhood" type="string" required>
      Bairro
    </ParamField>

    <ParamField body="address.city" type="string" required>
      Cidade
    </ParamField>

    <ParamField body="address.state" type="string" required>
      Estado (sigla de 2 caracteres, ex: `"SP"`)
    </ParamField>

    <ParamField body="address.postal_code" type="string" required>
      CEP (apenas números, 8 dígitos)
    </ParamField>

    <ParamField body="address.country" type="string" required>
      País (código ISO alpha-2, ex: `"BR"`)
    </ParamField>
  </Expandable>
</ParamField>

### Sócios Administradores

<ParamField body="managing_partners" type="array" required>
  Lista de sócios administradores (mínimo 1)

  <Expandable title="Dados de cada sócio">
    <ParamField body="managing_partners[].name" type="string" required>
      Nome completo do sócio
    </ParamField>

    <ParamField body="managing_partners[].email" type="string" required>
      Email do sócio
    </ParamField>

    <ParamField body="managing_partners[].document" type="string" required>
      CPF do sócio (11 dígitos)
    </ParamField>

    <ParamField body="managing_partners[].birthday" type="date" required>
      Data de nascimento (`YYYY-MM-DD`)
    </ParamField>

    <ParamField body="managing_partners[].nationality" type="string" required>
      Nacionalidade
    </ParamField>

    <ParamField body="managing_partners[].type" type="string" required>
      Tipo de sócio (2 caracteres, ex: `"AD"`)
    </ParamField>

    <ParamField body="managing_partners[].role_description" type="string" required>
      Descrição do cargo/função
    </ParamField>

    <ParamField body="managing_partners[].phone" type="object" required>
      <Expandable title="Telefone do sócio">
        <ParamField body="managing_partners[].phone.type" type="string" required>
          Tipo do telefone
        </ParamField>

        <ParamField body="managing_partners[].phone.ddd" type="string" required>
          DDD (2 dígitos)
        </ParamField>

        <ParamField body="managing_partners[].phone.number" type="string" required>
          Número do telefone (até 9 dígitos)
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

### Dados Bancários (Opcional)

<ParamField body="bank_account" type="object">
  Dados bancários para recebimento (se fornecido, todos os sub-campos são
  obrigatórios)

  <Expandable title="Dados da conta bancária">
    <ParamField body="bank_account.bank_ispb" type="string" required>
      Código ISPB do banco (8 dígitos)
    </ParamField>

    <ParamField body="bank_account.holder_name" type="string" required>
      Nome do titular da conta
    </ParamField>

    <ParamField body="bank_account.branch_number" type="string" required>
      Número da agência (sem dígito)
    </ParamField>

    <ParamField body="bank_account.branch_check_digit" type="string">
      Dígito verificador da agência (quando aplicável)
    </ParamField>

    <ParamField body="bank_account.account_number" type="string" required>
      Número da conta (sem dígito)
    </ParamField>

    <ParamField body="bank_account.account_check_digit" type="string" required>
      Dígito verificador da conta
    </ParamField>

    <ParamField body="bank_account.pix_key" type="string">
      Chave PIX (opcional)
    </ParamField>

    <ParamField body="bank_account.pix_key_type" type="string">
      Tipo da chave PIX (obrigatório se pix\_key fornecido)

      **Valores:** `cpf`, `cnpj`, `phone`, `email`, `random`
    </ParamField>

    <ParamField body="bank_account.status" type="string" required>
      Status da conta bancária

      **Valores:** `approved`, `pending`, `reproved`
    </ParamField>

    <ParamField body="bank_account.receiver_type" type="string" required>
      Tipo de conta

      **Valores:** `checking` (corrente), `saving` (poupança)
    </ParamField>
  </Expandable>
</ParamField>

### Metadados

<ParamField body="metadata" type="object">
  Dados adicionais personalizados (formato chave-valor)
</ParamField>

## Exemplos de Requisição

<CodeGroup>
  ```bash cURL - Pessoa Física theme={null}
  curl -X POST https://pay.autorizou.dev/api/v1/recipients \
    -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc" \
    -H "Content-Type: application/json" \
    -d '{
      "external_reference": "seller_001",
      "email": "maria.vendedora@exemplo.com.br",
      "legal_name": "Maria da Silva Vendedora",
      "trade_name": "Maria Vendedora",
      "status": "approved",
      "type": "individual",
      "company_type": "MEI",
      "name": "Maria da Silva Vendedora",
      "birthday": "1990-05-15",
      "document": {
        "type": "cpf",
        "value": "12345678901"
      },
      "phone": {
        "type": "mobile",
        "ddi": "55",
        "ddd": "11",
        "number": "987654321"
      },
      "address": {
        "type": "billing",
        "line_1": "Rua das Flores",
        "number": "123",
        "line_2": "Apto 45",
        "neighborhood": "Vila Madalena",
        "city": "São Paulo",
        "state": "SP",
        "postal_code": "01234567",
        "country": "BR"
      },
      "managing_partners": [
        {
          "name": "Maria da Silva Vendedora",
          "email": "maria@exemplo.com.br",
          "document": "12345678901",
          "birthday": "1990-05-15",
          "nationality": "brasileira",
          "type": "AD",
          "role_description": "Proprietária",
          "phone": {
            "type": "mobile",
            "ddd": "11",
            "number": "987654321"
          }
        }
      ],
      "bank_account": {
        "bank_ispb": "00000000",
        "holder_name": "Maria da Silva Vendedora",
        "branch_number": "1234",
        "account_number": "567890",
        "account_check_digit": "1",
        "status": "approved",
        "receiver_type": "checking"
      }
    }'
  ```

  ```bash cURL - Pessoa Jurídica theme={null}
  curl -X POST https://pay.autorizou.dev/api/v1/recipients \
    -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc" \
    -H "Content-Type: application/json" \
    -d '{
      "external_reference": "company_tech_store",
      "email": "financeiro@techstore.com.br",
      "legal_name": "Tech Store Comércio de Eletrônicos LTDA",
      "trade_name": "Tech Store",
      "status": "approved",
      "type": "company",
      "company_type": "LTDA",
      "founding_date": "2020-01-15",
      "document": {
        "type": "cnpj",
        "value": "12345678000195"
      },
      "phone": {
        "type": "commercial",
        "ddi": "55",
        "ddd": "11",
        "number": "33334444"
      },
      "address": {
        "type": "billing",
        "line_1": "Av. Paulista",
        "number": "1000",
        "line_2": "Sala 1001",
        "neighborhood": "Bela Vista",
        "city": "São Paulo",
        "state": "SP",
        "postal_code": "01310100",
        "country": "BR"
      },
      "managing_partners": [
        {
          "name": "João Silva Santos",
          "email": "joao@techstore.com.br",
          "document": "98765432100",
          "birthday": "1985-03-20",
          "nationality": "brasileira",
          "type": "AD",
          "role_description": "Diretor Administrativo",
          "phone": {
            "type": "mobile",
            "ddd": "11",
            "number": "988887777"
          }
        }
      ],
      "bank_account": {
        "bank_ispb": "60701190",
        "holder_name": "Tech Store Comércio de Eletrônicos LTDA",
        "branch_number": "5678",
        "account_number": "123456",
        "account_check_digit": "9",
        "status": "approved",
        "receiver_type": "checking",
        "pix_key": "financeiro@techstore.com.br",
        "pix_key_type": "email"
      }
    }'
  ```
</CodeGroup>

## Resposta

<ResponseField name="id" type="string">
  UUID único do destinatário
</ResponseField>

<ResponseField name="hash" type="string">
  Hash único do destinatário
</ResponseField>

<ResponseField name="email" type="string">
  Email do destinatário
</ResponseField>

<ResponseField name="created_at" type="string">
  Data/hora de criação (formato: `DD/MM/YYYY HH:mm:ss`)
</ResponseField>

<ResponseField name="updated_at" type="string">
  Data/hora da última atualização
</ResponseField>

### Exemplos de Resposta

```json 201 Created - Novo destinatário theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "hash": "RCP_abc123xyz789",
  "email": "maria.vendedora@exemplo.com.br",
  "created_at": "15/01/2024 10:30:00",
  "updated_at": "15/01/2024 10:30:00"
}
```

```json 200 OK - Recebedor já existe theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "hash": "RCP_abc123xyz789",
  "email": "maria.vendedora@exemplo.com.br",
  "created_at": "10/01/2024 14:20:00",
  "updated_at": "10/01/2024 14:20:00"
}
```

## Códigos de Status

<ResponseExample>
  ```json 422 - Validation Error theme={null}
  {
    "message": "Os dados fornecidos são inválidos",
    "errors": {
      "document.value": ["CPF inválido"],
      "email": ["O campo email é obrigatório"],
      "managing_partners": ["É necessário pelo menos um sócio administrador"]
    }
  }
  ```

  ```json 404 - Not Found theme={null}
  {
    "message": "País não encontrado",
    "errors": {
      "address.country": ["O país informado não existe"]
    }
  }
  ```
</ResponseExample>

## Próximos Passos

Após criar um destinatário:

1. [Buscar destinatário](/api-reference/recipients/get-recipient) para validar
   criação
2. [Atualizar dados](/api-reference/recipients/update-recipient) se necessário
3. [Usar em split de pagamento](/api-reference/charges/orders/create-order)
   para dividir valores