Skip to main content
POST
Adicionar representante legal

Authorizations

Authorization
string
header
required

Autenticação via chave de API. Use publicKey:secretKey codificado em Base64 no header Authorization: Basic {credentials}.

Path Parameters

id
string<uuid>
required

ID do submerchant

Body

application/json
name
string
required

Nome completo do sócio (PF) ou do responsável (PJ)

Required string length: 1 - 255
document
string
required

CPF (11 dígitos) ou CNPJ (14 dígitos). Chave de idempotência: chamadas com o mesmo documento atualizam o registro existente.

Required string length: 11 - 20
entity_type
enum<string>

Tipo do sócio. Default: pf.

Available options:
pf,
pj

Razão social, obrigatório quando entity_type = pj

Maximum string length: 255
birth_date
string<date>

Data de nascimento (YYYY-MM-DD), apenas PF

mother_name
string

Nome completo da mãe, apenas PF

Maximum string length: 255
email
string<email>

E-mail de contato do sócio

phone
string

Telefone do sócio

Maximum string length: 20
role
enum<string>

Função no contrato. Default: legal_representative.

Available options:
legal_representative,
individual_owner,
corporate_owner,
admin
qualification
enum<string>

Qualificação societária (usado em PJTAO)

Available options:
DIRECTOR,
ADMIN,
OWNER,
OWNER-ADMIN,
ATTORNEY
participation_percentage
number

Percentual de participação societária (0-100)

Required range: 0 <= x <= 100
is_admin
boolean

Marca o sócio como administrador da conta. Default: false.

Response

Representante legal salvo com sucesso

success
boolean
Example:

true

message
string
data
object