Create company account

Create a new company account

Creates a company customer (persona moral) with multipart/form-data. It follows the same flow as /user/v1/account/create: it creates the customer, its balance and its tokens, and the response carries the same identifiers and tokens plus the company data.

The company is always created with KYC level 1 and no OTP verification is requested.

Errors

  • 422: a field is missing or has an invalid format, the zipcode does not exist, or another customer of the e-commerce already has the same RFC. The response names the field.
  • 400: another customer of the e-commerce already has the same email (User with same Email already exists) or the same mobile (User with same Mobile already exists).
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length ≤ 255

An identifier for the company's device.
This id will be required to obtain authentication tokens to
communicate with other endpoints (Authorization-customer header)

string
required

A password hash

string
required
length ≤ 255

The company's contact email address. It must not belong to another customer of the e-commerce

int64
required
1000000000 to 9999999999

The company's contact mobile phone number. It must not belong to another customer of the e-commerce. 10 digits when the country code is +52

string
^\+?[0-9]{1,3}$

Optional country calling code for the mobile number. The leading “+” may be included or omitted. If no value is provided, the default country code +52 is assumed.

string
length ≤ 255

The company's trade name (nombre comercial)

string
required
length between 12 and 12
^[A-Za-zÑñ&]{3}[0-9]{2}(0[1-9]|1[0-2])(0[1-9]|[12][0-9]|3[01])[A-Za-z0-9]{2}[Aa0-9]$

The company's Registro Federal de Contribuyentes (RFC): the 12 character RFC of a persona moral (3 letters, the incorporation date as YYMMDD and a 3 character homoclave). Lowercase letters are accepted and stored in uppercase. Only the format is validated. It must not belong to another customer of the e-commerce

string
enum
required

The company's tax regime: a key of the SAT c_RegimenFiscal catalog (CFDI 4.0), for example 601 (General de Ley Personas Morales)

string
required
length ≤ 255

Street of the fiscal address (domicilio fiscal)

string
required
length ≤ 50

Exterior number of the fiscal address

string
length ≤ 50

Interior number of the fiscal address

string
required
length ≤ 255

Neighborhood (colonia) of the fiscal address

string
required
^[0-9]{5}$

Zipcode of the fiscal address. 5 digits; it must be an existing zipcode

string
required
length ≤ 255

Municipality (municipio or alcaldía) of the fiscal address

string
required
length ≤ 100

State of the fiscal address

Headers
string
required

OAuth token belonging to the e-commerce

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*