> ## 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.

# Atualizar Recebedor

> Atualize dados cadastrais, bancários e de status de um destinatário existente

Permite atualizar informações de destinatários já cadastrados. Todos os campos
são opcionais - envie apenas os dados que deseja modificar.

## Parâmetros da Requisição

<ParamField path="uuid" type="string" required>
  Identificador único do destinatário

  **Aceita:** UUID completo ou hash do destinatário

  **Exemplos:**

  * UUID: `"550e8400-e29b-41d4-a716-446655440000"`
  * Hash: `"RCP_abc123xyz789"`
</ParamField>

### Body Parameters (Todos Opcionais)

<ParamField body="external_reference" type="string">
  Atualizar identificador externo
</ParamField>

<ParamField body="email" type="string">
  Atualizar email
</ParamField>

<ParamField body="legal_name" type="string">
  Atualizar nome legal/razão social
</ParamField>

<ParamField body="trade_name" type="string">
  Atualizar nome fantasia
</ParamField>

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

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

<ParamField body="type" type="string">
  Atualizar tipo de pessoa

  **Valores:** `individual`, `company`
</ParamField>

<ParamField body="company_type" type="string">
  Atualizar tipo de empresa

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

<ParamField body="name" type="string">
  Atualizar nome completo (para pessoa física)
</ParamField>

<ParamField body="birthday" type="date">
  Atualizar data de nascimento (`YYYY-MM-DD`)
</ParamField>

<ParamField body="founding_date" type="date">
  Atualizar data de fundação (`YYYY-MM-DD`)
</ParamField>

### Documento

<ParamField body="document" type="object">
  Atualizar dados do documento

  <Expandable title="Campos do documento">
    <ParamField body="document.type" type="string">
      Tipo: `cpf`, `cnpj`
    </ParamField>

    <ParamField body="document.value" type="string">
      Número do documento (apenas dígitos)
    </ParamField>
  </Expandable>
</ParamField>

### Telefone

<ParamField body="phone" type="object">
  Atualizar dados do telefone

  <Expandable title="Campos do telefone">
    <ParamField body="phone.type" type="string">
      **Valores:** `residential`, `mobile`, `commercial`, `public`
    </ParamField>

    <ParamField body="phone.ddi" type="string">
      Código DDI
    </ParamField>

    <ParamField body="phone.ddd" type="string">
      Código DDD (2 dígitos)
    </ParamField>

    <ParamField body="phone.number" type="string">
      Número (máx 9 dígitos)
    </ParamField>
  </Expandable>
</ParamField>

### Endereço

<ParamField body="address" type="object">
  Atualizar dados do endereço

  <Expandable title="Campos do endereço">
    <ParamField body="address.type" type="string">
      **Valores:** `billing`, `shipping`
    </ParamField>

    <ParamField body="address.line_1" type="string">
      Logradouro
    </ParamField>

    <ParamField body="address.number" type="string">
      Número
    </ParamField>

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

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

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

    <ParamField body="address.state" type="string">
      Estado (sigla de 2 caracteres)
    </ParamField>

    <ParamField body="address.postal_code" type="string">
      CEP (8 dígitos)
    </ParamField>

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

### Sócios Administradores

<ParamField body="managing_partners" type="array">
  Atualizar lista de sócios (substitui completamente a lista existente)

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

    <ParamField body="managing_partners[].email" type="string">
      Email
    </ParamField>

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

    <ParamField body="managing_partners[].birthday" type="date">
      Data de nascimento
    </ParamField>

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

    <ParamField body="managing_partners[].type" type="string">
      Tipo de sócio (2 caracteres)
    </ParamField>

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

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

### Dados Bancários

<ParamField body="bank_account" type="object">
  Adicionar ou atualizar dados bancários

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

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

    <ParamField body="bank_account.branch_number" type="string">
      Número da agência
    </ParamField>

    <ParamField body="bank_account.branch_check_digit" type="string">
      Dígito da agência (opcional)
    </ParamField>

    <ParamField body="bank_account.account_number" type="string">
      Número da conta
    </ParamField>

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

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

    <ParamField body="bank_account.pix_key_type" type="string">
      **Valores:** `cpf`, `cnpj`, `phone`, `email`, `random`
    </ParamField>

    <ParamField body="bank_account.status" type="string">
      **Valores:** `approved`, `pending`, `reproved`
    </ParamField>

    <ParamField body="bank_account.receiver_type" type="string">
      **Valores:** `checking`, `saving`
    </ParamField>
  </Expandable>
</ParamField>

### Metadados

<ParamField body="metadata" type="object">
  Atualizar ou adicionar metadados personalizados
</ParamField>

## Exemplos de Requisição

<CodeGroup>
  ```bash cURL - Atualizar Status theme={null}
  curl -X PUT https://pay.autorizou.dev/api/v1/recipients/550e8400-e29b-41d4-a716-446655440000 \
    -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc" \
    -H "Content-Type: application/json" \
    -d '{
      "status": "approved"
    }'
  ```

  ```bash cURL - Adicionar Dados Bancários theme={null}
  curl -X PUT https://pay.autorizou.dev/api/v1/recipients/RCP_abc123xyz789 \
    -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc" \
    -H "Content-Type: application/json" \
    -d '{
      "bank_account": {
        "bank_ispb": "60701190",
        "holder_name": "Maria da Silva Vendedora",
        "branch_number": "1234",
        "account_number": "567890",
        "account_check_digit": "1",
        "status": "approved",
        "receiver_type": "checking",
        "pix_key": "maria@exemplo.com.br",
        "pix_key_type": "email"
      }
    }'
  ```

  ```bash cURL - Atualizar Email e Telefone theme={null}
  curl -X PUT https://pay.autorizou.dev/api/v1/recipients/550e8400-e29b-41d4-a716-446655440000 \
    -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc" \
    -H "Content-Type: application/json" \
    -d '{
      "email": "novo.email@exemplo.com.br",
      "phone": {
        "type": "mobile",
        "ddi": "55",
        "ddd": "11",
        "number": "999888777"
      }
    }'
  ```
</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 atualizado 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 (atualizado para o momento atual)
</ResponseField>

### Exemplo de Resposta

```json 200 OK theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "hash": "RCP_abc123xyz789",
  "email": "novo.email@exemplo.com.br",
  "created_at": "15/01/2024 10:30:00",
  "updated_at": "25/01/2024 16:20:00"
}
```

## Códigos de Status

<ResponseExample>
  ```json 404 - Not Found theme={null}
  {
    "error": "Recebedor não encontrado"
  }
  ```

  ```json 422 - Validation Error theme={null}
  {
    "message": "Os dados fornecidos são inválidos",
    "errors": {
      "email": ["O formato do email é inválido"],
      "phone.number": ["O número deve ter no máximo 9 dígitos"],
      "bank_account.bank_ispb": ["O código ISPB deve ter 8 dígitos"]
    }
  }
  ```

  ```json 401 - Unauthorized theme={null}
  {
    "message": "Unauthenticated."
  }
  ```
</ResponseExample>

## Próximos Passos

Após atualizar um destinatário:

1. [Buscar destinatário](/api-reference/recipients/get-recipient) para validar
   atualização
2. [Verificar splits existentes](/api-reference/payments/list-payments) usando
   este destinatário
3. [Testar split](/api-reference/charges/orders/create-order) com dados
   atualizados