Skip to main content
POST
/
v2
/
register
/
companies
Account Opening Request
curl --request POST \
  --url https://api.sandbox.wepayout.com.br/v2/register/companies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "legal_name": "<string>",
  "trade_name": "<string>",
  "tax_id": "<string>",
  "contacts": {
    "name": "<string>",
    "email": "<string>",
    "phone": "<string>",
    "role": "<string>",
    "tax_id": "<string>"
  },
  "address": {
    "city": "<string>",
    "state": "<string>",
    "country": "<string>",
    "zip_code": "<string>",
    "street": "<string>",
    "number": "<string>",
    "complement": "<string>"
  }
}
'
{
  "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
{
  "id": "339074a8-1834-49c5-af94-4a044248d88d",
  "status": "pending"
}

Setup Webhook

Configure webhook notifications for onboarding events

Update Webhook

Update existing webhook configuration