Empresas e sócios
Nesta página
Crie a proposta da empresaQuem preenche e os sóciosAnálise da empresaErros desta operaçãoAbra a conta de uma empresa com uma pessoa preenchendo em nome dela e os sócios fazendo a parte de cada um na jornada.
Crie a proposta da empresa
Mande type em COMPANY, o CNPJ em taxId e, em prefill, os dados da empresa e o quadro societário que você já tem.
curl --request POST \
--url 'https://api.sandbox.payzu.dev/v1/proposals' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"clientCode": "crm-9001",
"type": "COMPANY",
"taxId": "11.222.333/0001-81",
"contact": "financeiro@empresa.com.br",
"prefill": {
"companyData": {
"legalName": "Empresa Exemplo Ltda",
"tradeName": "Exemplo",
"email": "contato@empresa.com.br"
},
"members": {
"members": [
{
"taxId": "12345678909",
"name": "Sócia A",
"role": "PARTNER",
"ownershipPercent": 100,
"isLegalRepresentative": true
}
]
}
}
}'{
"id": "cmf0p8x1a0001qk08prop0002",
"clientCode": "crm-9001",
"type": "COMPANY",
"taxId": "11222333000181",
"contact": "financeiro@empresa.com.br",
"status": "IN_PROGRESS",
"delivery": "LINK",
"expiresAt": "2026-09-24T12:00:00.000Z",
"submittedAt": null,
"decidedAt": null,
"version": 1,
"createdAt": "2026-09-17T12:00:00.000Z",
"updatedAt": "2026-09-17T12:00:00.000Z",
"journeyUrl": "https://jornada.sandbox.payzu.dev/Qm9hIHZpYWdlbSBkZSB0ZXN0ZSBkbyBsaW5r",
"embedUrl": null
}Referência: Criar uma proposta de abertura de conta
| Campo | Regra |
|---|---|
prefill.companyData | Exige legalName e email. |
prefill.members | Cada sócio exige taxId, name e role. Só é gravado junto com companyData. |
O quadro de sócios enviado substitui o quadro inteiro.
Mande todos os sócios de uma vez. Sem prefill, quem preenche informa a empresa e os sócios na jornada.
Quem preenche e os sócios
| Quem | O que faz |
|---|---|
| Quem abre o link | Preenche em nome da empresa e informa o próprio CPF em PERSONAL_DATA. Na etapa de sócios, convida quem precisa fazer a captura de documento e selfie. |
| Sócio convidado | Faz a parte dele numa proposta própria, ligada à da empresa e com o mesmo vencimento. Quando termina, a proposta dele fica SUBMITTED. |
Análise da empresa
No envio da proposta da empresa, nasce uma verificação de pessoa para quem preencheu e para cada sócio exigido, ligadas à verificação da empresa.
A proposta do sócio não gera callback.
Acompanhe por proposal.decided e proposal.waiting_data da proposta da empresa e pelo status na consulta dela, como mostra Envio e análise. O pedido de dados a um sócio não gera callback, e a proposta da empresa segue em IN_ANALYSIS, sem mostrar o pedido.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
client_code_conflict | 409 | O clientCode já foi usado com outro conteúdo. |
journey_incomplete | 409 | conclua COMPANY_DATA antes de MEMBERS |
Autenticação e validação estão no Catálogo de erros.