Create account (Personal or Business)

post

https://sandcaas.undostres.com.mx/user/v1/account/create

Creates a new customer account with an initial wallet balance and optional composite balance.

Validates unique identifiers and generates OAuth tokens for authentication.

This endpoint supports both personal and business accounts. The account type is determined by the gender field value.

All operations are performed atomically.

Note: You can create an account configured to have Composite Balance.

Account type behavior

This endpoint supports personal and business accounts.

Personal accounts:
- gender must be 1 (male) or 2 (female)
- middle_name and second_last_name can be used
- RFC must be 13 characters long (for individuals)
- CURP can be provided as an alternative identifier
Business accounts:
- gender must be 3
- first_name joined to last_name must contain the legal or commercial name
- middle_name and second_last_name must NOT be sent
- RFC must be 12 characters long (for legal entities)
- CURP is not applicable for business accounts

Response Examples

Successful response (200)

{
  "err": null,
  "rs": {
    "id": 10734,
    "ecommerce_id": 2,
    "email": "[email protected]",
    "first_name": "Juan",
    "last_name": "Perez",
    "gender": 2,
    "gender_string": "Male",
    "mobile": 5056595854,
    "mobile_country_code": "+52",
    "rfc": "PEGJ831111BM9",
    "ewallet_id": 10930,
    "ewallet_status": 1,
    "oauth_token": "eae41c1a4ab1bf5593e4f2f55870ebe4f970b7bfb29d7bce2d8f7b52d331d3e4",
    "private_key": "sk_ad67984acba263607ebc88be36afc80bb0576ffdec6ae22d5ec11692f5eb58ef",
    "refresh_token": "b74d97049a4a50011dc115e9e83305bc04dee7f1708fe4f54d552232943eacb9"
  }
}

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

gender

int64

enum

required

Type of account to create.

1, 2: If Personal account (1 = female, 2 = male)
3: If Business account

Allowed:

kyc_level

int64

enum

required

Know Your Customer (KYC) level. Should always be set to 1

Allowed:

device_id

string

required

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

string

required

The customer's email address (personal accounts) or business email address (business accounts).
Must be unique per user account.

first_name

string

required

The customer's first name (personal accounts) or the legal/commercial name (business accounts).
For business accounts, this represents the legal or commercial name.

middle_name

string

Personal accounts only

The customer's middle name, if applicable. Must NOT be sent for business accounts.

last_name

string

required

The customer's last name (personal accounts) or business representative's last name (business accounts).
For business accounts, when combined with first_name, must contain the complete legal or commercial name.

second_last_name

string

Personal accounts only

The customer's second last name, if applicable. Must NOT be sent for business accounts.

mobile

string

required

The customer's mobile phone number (personal accounts) or business phone number (business accounts).
Must be unique and valid.

mobile_country_code

string

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.

rfc

string

required

The customer's Registro Federal de Contribuyentes (RFC).

Personal accounts: Must be 13 characters long
Business accounts: Must be 12 characters long

zipcode

string

The customer's zipcode (personal accounts) or business zipcode (business accounts).

campaign_id

string

User program for this account. Optional - a default campaign will be used if not provided.

credit_line

int64

The credit line for this account in cents.
Optional - used to create an account with Composite Balance.

password

A password hash

Headers

authorization-ecommerce

string

required

OAuth token belonging to the e-commerce

Responses

200Response when creating a new account

401Unauthorized - Invalid or missing authentication token. Error code 8008 - E-commerce token has expired Error code 8010 - OAuth token has expired

422Unprocessable Entity - Invalid or inconsistent parameters. Error code 5000 - Parameter validation errors: Invalid or inconsistent parameters Missing required fields Business account cannot have middle_name or second_last_name Personal account missing required personal information

500Internal failure