Skip to main content
PUT
/
api
/
v1
/
recipients
/
{uuid}
Atualizar Recebedor
curl --request PUT \
  --url https://zeus-sandbox.autorizou.dev/api/v1/recipients/{uuid} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_reference": "<string>",
  "email": "<string>",
  "legal_name": "<string>",
  "trade_name": "<string>",
  "status": "<string>",
  "type": "<string>",
  "company_type": "<string>",
  "name": "<string>",
  "birthday": "<string>",
  "founding_date": "<string>",
  "document": {
    "document.type": "<string>",
    "document.value": "<string>"
  },
  "phone": {
    "phone.type": "<string>",
    "phone.ddi": "<string>",
    "phone.ddd": "<string>",
    "phone.number": "<string>"
  },
  "address": {
    "address.type": "<string>",
    "address.line_1": "<string>",
    "address.number": "<string>",
    "address.line_2": "<string>",
    "address.neighborhood": "<string>",
    "address.city": "<string>",
    "address.state": "<string>",
    "address.postal_code": "<string>",
    "address.country": "<string>"
  },
  "managing_partners": [
    {
      "managing_partners[].name": "<string>",
      "managing_partners[].email": "<string>",
      "managing_partners[].document": "<string>",
      "managing_partners[].birthday": "<string>",
      "managing_partners[].nationality": "<string>",
      "managing_partners[].type": "<string>",
      "managing_partners[].role_description": "<string>",
      "managing_partners[].phone": {}
    }
  ],
  "bank_account": {
    "bank_account.bank_ispb": "<string>",
    "bank_account.holder_name": "<string>",
    "bank_account.branch_number": "<string>",
    "bank_account.branch_check_digit": "<string>",
    "bank_account.account_number": "<string>",
    "bank_account.account_check_digit": "<string>",
    "bank_account.pix_key": "<string>",
    "bank_account.pix_key_type": "<string>",
    "bank_account.status": "<string>",
    "bank_account.receiver_type": "<string>"
  },
  "metadata": {}
}
'
{
  "error": "Recebedor não encontrado"
}
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

​
uuid
string
required
Identificador único do destinatárioAceita: UUID completo ou hash do destinatárioExemplos:
  • UUID: "550e8400-e29b-41d4-a716-446655440000"
  • Hash: "RCP_abc123xyz789"

​
Body Parameters (Todos Opcionais)

​
external_reference
string
Atualizar identificador externo
​
email
string
Atualizar email
​
legal_name
string
Atualizar nome legal/razão social
​
trade_name
string
Atualizar nome fantasia
​
status
string
Atualizar status do destinatárioValores: approved, pending, blocked, reproved
​
type
string
Atualizar tipo de pessoaValores: individual, company
​
company_type
string
Atualizar tipo de empresaValores: MEI, ME, EPP, LTDA, EIRELI, SA, AUT, OTHER
​
name
string
Atualizar nome completo (para pessoa física)
​
birthday
date
Atualizar data de nascimento (YYYY-MM-DD)
​
founding_date
date
Atualizar data de fundação (YYYY-MM-DD)

​
Documento

​
document
object
Atualizar dados do documento

​
Telefone

​
phone
object
Atualizar dados do telefone

​
Endereço

​
address
object
Atualizar dados do endereço

​
Sócios Administradores

​
managing_partners
array
Atualizar lista de sócios (substitui completamente a lista existente)

​
Dados Bancários

​
bank_account
object
Adicionar ou atualizar dados bancários

​
Metadados

​
metadata
object
Atualizar ou adicionar metadados personalizados

​
Exemplos de Requisição

curl -X PUT https://zeus-sandbox.autorizou.dev/api/v1/recipients/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "approved"
  }'

​
Resposta

​
id
string
UUID único do destinatário
​
hash
string
Hash único do destinatário
​
email
string
Email atualizado do destinatário
​
created_at
string
Data/hora de criação (formato: DD/MM/YYYY HH:mm:ss)
​
updated_at
string
Data/hora da última atualização (atualizado para o momento atual)

​
Exemplo de Resposta

200 OK
{
  "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

{
  "error": "Recebedor não encontrado"
}

​
Próximos Passos

Após atualizar um destinatário:
  1. Buscar destinatário para validar atualização
  2. Verificar splits existentes usando este destinatário
  3. Testar split com dados atualizados