PayZu OnboardingPropostas

Empresas e sócios


Nesta páginaCrie a proposta da empresaQuem preenche e os sóciosAnálise da empresaErros desta operação

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

bash
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
          }
        ]
      }
    }
  }'

Referência: Criar uma proposta de abertura de conta

CampoRegra
prefill.companyDataExige legalName e email.
prefill.membersCada 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

QuemO que faz
Quem abre o linkPreenche 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 convidadoFaz 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ódigoHTTPMensagem
client_code_conflict409O clientCode já foi usado com outro conteúdo.
journey_incomplete409conclua COMPANY_DATA antes de MEMBERS

Autenticação e validação estão no Catálogo de erros.