Create parent balance

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

Create a new customer and a composite balance parent for that customer.

This endpoint registers the customer’s personal information, assigns the appropriate KYC level, creates the initial balance, and generates OAuth tokens for immediate authentication.

If composite balances are enabled for the e-commerce, a composite balance parent structure is automatically created. All operations are transactional—if any step fails, the entire process is rolled back to ensure data consistency.

The schema for composite_balance.parent JSON

Key	Type	Max length	Required	Description	Example value
parent	object	N/A	true	Information about the composite balance parent to be created	See below for schema

The schema for composite_balance.parent JSON

Key	Type	Max length	Required	Description	Example value
credit_line	int	N/A	true	The composite balance parent’s credit line in Mexican cents	10000000

Successfully Response

The response's schema up to depth 1 is:

{
  "rs": Object,
  "en": Object
}

Where the err JSON will contain information on any error that may have occurred and will be null if the whole account creation process was completed successfully.

The rs JSON contains a number of fields used for validating the new account’s creation, except for the following which must be saved to be used when communicating with other endpoints.

The parent object's schema is:

{
  "rs": {
    "account_level": 1,
    "account_status": 1,
    "account_status_string": "Active",
    "address": "",
    "address_document_back": "",
    "address_document_back_url": "",
    "address_document_front": "",
    "address_document_front_url": "",
    "address_document_type": 0,
    "are_account_resources_of_user": false,
    "business_name": "",
    "business_purpose": "",
    "clabe": "",
    "city": "",
    "colony": "",
    "constitution_date": "",
    "correspondence_address": "",
    "country_of_birth": "",
    "date_of_birth": "",
    "ecommerce_id": 91,
    "email": "[email protected]",
    "exterior": "",
    "first_name": "Juan",
    "gender": 2,
    "gender_string": "Male",
    "id": 85,
    "identification_document_back": "",
    "identification_document_back_url": "",
    "identification_document_front": "",
    "identification_document_front_url": "",
    "identification_document_type": 0,
    "interior": "",
    "is_business": false,
    "last_name": "Pérez",
    "mobile": 4958129198,
    "mobile_country_code": "52",
    "nationality_id": 0,
    "oauth_token": "ad189de7f4205b9ae6564bcc518541eec690e28d48d2ddd34b92ac04054eea81",
    "occupation_id": 0,
    "person_type": 1,
    "private_key": "sk_d3eed26644afbda16544db7639a6bb250ffaea17b7b21762a6a4fb0fcf954559",
    "rfc": "AAA000101055",
    "refresh_token": "28f352fa15967f8e8e45eb4b0d81bca832bc2d9fd067be9a33750d1043eb0ded",
    "risk_level": 0,
    "second_last_name": "Gómez",
    "society_type": 0,
    "selfie": "",
    "selfie_url": "",
    "state_id": 0,
    "street": "",
    "telephone": "",
    "zipcode": "",
    "composite_balance": {
      "parent": {
        "id": "66acce83856147e791206ca90a6e4b6d"
      }
    }
  },
  "err": null
}