Skip to main content
POST
https://api.sandbox.wepayout.com.br
/
v2
/
register
/
companies
curl --request POST \
  --url https://api.sandbox.wepayout.com.br/v2/register/companies \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer 123' \
  --header 'Content-Type: application/json' \
  --data '{
  "legal_name": "Company X LTDA",
  "trade_name": "Company X",
  "tax_id": "12345678000199",
  "contacts": [
    {
      "name": "João Silva",
      "email": "[email protected]",
      "phone": "5511999999999",
      "role": "administrator",
      "tax_id": "12345678909"
    },
    {
      "name": "Maria Silva",
      "email": "[email protected]",
      "phone": "5511999999990",
      "role": "legal_representative",
      "tax_id": "12345678900"
    }
  ],
  "address": {
    "city": "São Paulo",
    "state": "SP",
    "country": "BR",
    "zip_code": "01001000",
    "street": "Av. Paulista",
    "number": "1000",
    "complement": "Conjunto 12"
  }
}'

{
  "id": "339074a8-1834-49c5-af94-4a044248d88d",
  "status": "pending"
}

​
Allowed Roles

RoleRequired
administrator✓
legal_representative✓
financial✗
commercial✗

​
Request Body

​
legal_name
string
required
Official registered name of the company as it appears in legal documents.
  • Min: 1 character
  • Max: 100 characters
  • Example: Company X LTDA
​
trade_name
string
required
Common or commercial name used by the company in business operations.
  • Min: 1 character
  • Max: 100 characters
  • Example: Company X
​
tax_id
string
required
Company’s tax identification number (CNPJ for Brazilian companies), without formatting.
  • If country = BR: max 14 characters (valid CNPJ)
  • If country ≠ BR: max 50 characters
  • Example: 12345678000199
​
contacts
array[object]
required
List of individuals associated with the company, such as administrators, legal representatives, or other relevant roles.
​
address
object
required
Company’s main business address.

​
Response

​
id
string
Unique identifier of the corporate subaccount opening request.
  • Format: UUID
  • Example: 339074a8-1834-49c5-af94-4a044248d88d
​
status
string
Current status of the onboarding request.
  • Default: pending
curl --request POST \
  --url https://api.sandbox.wepayout.com.br/v2/register/companies \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer 123' \
  --header 'Content-Type: application/json' \
  --data '{
  "legal_name": "Company X LTDA",
  "trade_name": "Company X",
  "tax_id": "12345678000199",
  "contacts": [
    {
      "name": "João Silva",
      "email": "[email protected]",
      "phone": "5511999999999",
      "role": "administrator",
      "tax_id": "12345678909"
    },
    {
      "name": "Maria Silva",
      "email": "[email protected]",
      "phone": "5511999999990",
      "role": "legal_representative",
      "tax_id": "12345678900"
    }
  ],
  "address": {
    "city": "São Paulo",
    "state": "SP",
    "country": "BR",
    "zip_code": "01001000",
    "street": "Av. Paulista",
    "number": "1000",
    "complement": "Conjunto 12"
  }
}'

{
  "id": "339074a8-1834-49c5-af94-4a044248d88d",
  "status": "pending"
}

Setup Webhook

Configure webhook notifications for onboarding events

Update Webhook

Update existing webhook configuration