# Crear cuenta hija

Esta API permite crear y gestionar cobros de manera flexible, adaptándose a diferentes escenarios de pago: creados, programados y normales. Los cobros pueden personalizarse con reglas de vencimiento, recargos, descuentos anticipados y notificaciones automatizadas, garantizando una integración sencilla y escalable para el comercio. **Es esencial que te asegures de generar un único cobro por cada venta, pedido o interacción con el cliente, según sea apropiado.** 

## Ruta

<mark style="color:green;">`POST`</mark> `/v1/business/child`

## **Encabezado**

| Name                                                   | Value            |
| ------------------------------------------------------ | ---------------- |
| `Content-Type`*<mark style="color:red;">**\***</mark>* | application/json |
| `x-auth-token`*<mark style="color:red;">**\***</mark>* | {token}          |

## **Cuerpo**&#x20;

### **Datos del Negocio**

<table><thead><tr><th width="249">Name</th><th width="126">Type<select><option value="GnWreahNlF6F" label="numeric" color="blue"></option><option value="sFwIPm2Dqll0" label="string" color="blue"></option><option value="l8UgNW8hbMuc" label="date" color="blue"></option><option value="VIiuN2CCxiaY" label="boolean" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><code>business_id</code><em><mark style="color:red;"><strong>*</strong></mark></em></td><td><span data-option="sFwIPm2Dqll0">string</span></td><td>Es el identificador único que se le asignará al negocio hijo en el sistema</td></tr><tr><td><code>business_name</code><em><mark style="color:red;"><strong>*</strong></mark></em></td><td><span data-option="sFwIPm2Dqll0">string</span></td><td>Nombre comercial de la sede o del sub-negocio.</td></tr><tr><td><code>type</code><em><mark style="color:red;"><strong>*</strong></mark></em></td><td><span data-option="sFwIPm2Dqll0">string</span></td><td><p>Categoría del negocio.</p><p></p><p><mark style="color:green;"><code>general | logistic</code></mark> </p></td></tr><tr><td><code>business_id_type</code></td><td><span data-option="sFwIPm2Dqll0">string</span></td><td>Tipo de documento de identificación del negocio.<br><br><mark style="color:green;"><code>CC | CE | NIT | PASAPORTE | DNI | EIN</code></mark></td></tr><tr><td><code>business_id_number</code></td><td><span data-option="sFwIPm2Dqll0">string</span></td><td>Número de identificación de la empresa (NIT sin DV).</td></tr><tr><td><code>business_id_number_dv</code></td><td><span data-option="GnWreahNlF6F">numeric</span></td><td>Dígito de verificación de la empresa<br><br><em><mark style="color:blue;"><code>Ejemplo: 1</code></mark></em></td></tr><tr><td><code>business_phone</code></td><td><span data-option="sFwIPm2Dqll0">string</span></td><td>Número de celular del negocio.<br><br><em><mark style="color:blue;"><code>Ejemplo: 573112229999</code></mark></em></td></tr><tr><td><code>business_email</code></td><td><span data-option="sFwIPm2Dqll0">string</span></td><td>Correo electrónico de contacto comercial del sub-negocio.<br><br><em><mark style="color:blue;"><code>Ejemplo: alguien@ejemplo.com</code></mark></em></td></tr><tr><td><code>business_webhook</code></td><td><span data-option="sFwIPm2Dqll0">string</span></td><td>URL del webhook donde el sub-negocio recibirá los eventos de notificación.<br><br><em><mark style="color:blue;"><code>Ejemplo:https://minegocio.com/mi-aplicacion</code></mark></em></td></tr></tbody></table>

### **Datos de Contacto (Usuario Principal)**

Están relacionados directamente con la persona que será el contacto principal de este sub-negocio:

<table><thead><tr><th width="249">Name</th><th width="113">Type<select><option value="tW4OOsURXuNZ" label="string" color="blue"></option><option value="zBWjm30t6gu5" label="number" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:yellow;"><code>first_name</code></mark></td><td><span data-option="tW4OOsURXuNZ">string</span></td><td>Nombre del contacto principal.</td></tr><tr><td><mark style="color:yellow;"><code>last_name</code></mark></td><td><span data-option="tW4OOsURXuNZ">string</span></td><td>Apellido del contacto principal.</td></tr><tr><td><mark style="color:yellow;"><code>nickname</code></mark></td><td><span data-option="tW4OOsURXuNZ">string</span></td><td>Apodo o nombre corto para el contacto.</td></tr><tr><td><mark style="color:yellow;"><code>phone</code></mark></td><td><span data-option="tW4OOsURXuNZ">string</span></td><td>Número de teléfono móvil del contacto principal (debe tener entre 10 y 15 dígitos numéricos).</td></tr><tr><td><mark style="color:yellow;"><code>user_email</code></mark></td><td><span data-option="tW4OOsURXuNZ">string</span></td><td>Correo electrónico válido del contacto.</td></tr><tr><td><mark style="color:yellow;"><code>user_id_type</code></mark></td><td><span data-option="tW4OOsURXuNZ">string</span></td><td>Tipo de documento de identificación del contacto principal.<br><br><mark style="color:green;"><code>CC | CE | NIT | PASAPORTE | DNI | EIN</code></mark></td></tr><tr><td><mark style="color:yellow;"><code>user_id_number</code></mark></td><td><span data-option="tW4OOsURXuNZ">string</span></td><td>Número de identificación del usuario.</td></tr><tr><td><mark style="color:yellow;"><code>user_id_number_dv</code></mark></td><td><span data-option="zBWjm30t6gu5">number</span></td><td>Dígito de verificación del documento del usuario (opcional, por defecto es <code>null</code>).</td></tr></tbody></table>

### Apariencia y Ubicación

Campos adicionales que permiten que el hijo tenga su propio estilo y ubicación geográfica separada del padre:

<table><thead><tr><th width="249">Name</th><th width="113">Type<select><option value="rRB3kMFO5APd" label="string" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:orange;"><code>logo</code></mark></td><td><span data-option="rRB3kMFO5APd">string</span></td><td>URL (URI válida) con la imagen del logo del sub-negocio.</td></tr><tr><td><mark style="color:orange;"><code>main_color_brand</code></mark> </td><td><span data-option="rRB3kMFO5APd">string</span></td><td>Código HEX del color principal de la marca <em><mark style="color:blue;"><code>Ejemplo #FF0000</code></mark></em></td></tr><tr><td><mark style="color:orange;"><code>secondary_color_brand</code></mark> </td><td><span data-option="rRB3kMFO5APd">string</span></td><td>Código HEX del color secundario de la marca.<br><em><mark style="color:blue;"><code>Ejemplo #FF0000</code></mark></em></td></tr><tr><td><mark style="color:orange;"><code>city</code></mark> </td><td><span data-option="rRB3kMFO5APd">string</span></td><td>Ciudad principal de operación.</td></tr><tr><td><mark style="color:orange;"><code>state</code></mark></td><td><span data-option="rRB3kMFO5APd">string</span></td><td>Departamento o estado provincial de operación.</td></tr><tr><td><mark style="color:orange;"><code>country</code></mark> </td><td><span data-option="rRB3kMFO5APd">string</span></td><td>País de operación.</td></tr></tbody></table>

### **Configuración Financiera**

<table><thead><tr><th width="249">Name</th><th width="113">Type<select><option value="CRQXJNwgXiB2" label="string" color="blue"></option><option value="DSyQfsQTOGwM" label="number" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:blue;"><code>fee_variable_saas</code></mark> </td><td><span data-option="DSyQfsQTOGwM">number</span></td><td>Tarifa (fee) variable aplicada bajo el modelo SaaS para este sub-negocio específico. Se espera un número entre <code>0</code> y <code>1</code>(por defecto es <code>0</code><br><br><em><mark style="color:blue;"><code>Ejemplo: 0.1</code></mark></em></td></tr><tr><td><mark style="color:blue;"><code>fee_fixed_saas</code></mark> </td><td><span data-option="DSyQfsQTOGwM">number</span></td><td>Tarifa (fee) fija aplicada bajo el modelo SaaS para este sub-negocio específico.<br><br><em><mark style="color:blue;"><code>Ejemplo: 2000</code></mark></em></td></tr></tbody></table>

## **Respuesta**

{% tabs %}
{% tab title="200" %}

```json
{
  "message": "Child business creado exitosamente 🚀",
  "business_id": "PAY-CHILD-001",
  "managing_business_id": "PAY-001",
  "created_at": "2023-10-15T08:00:00-05:00"
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "error": [
        "\"amount\" must be a number"
    ]
}
```

{% endtab %}

{% tab title="401" %}

```bash
{
    "status": "unauthorized",
    "code": "Q103",
    "error": "El x-auth-token se encuentra vencido. Por favor genera un nuevo token y reintenta de nuevo el cobro."
}
```

{% endtab %}
{% endtabs %}

***

## Ejemplo

{% tabs %}
{% tab title="cURL" %}

```bash
curl --location '{{base_url}}/v1/business/child' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: token' \
--data '{
  "phone": "",
  "first_name": "",
  "last_name": "",
  "nickname": "",
  "user_id_type": "",
  "user_id_number": "",
  "user_email": "",
  "user_id_number_dv": null,
  "type": "general",
  "business_id": "",
  "business_name": "",
  "business_id_type": "",
  "business_id_number": 1,
  "business_id_number_dv": 1,
  "business_url": "",
  "business_phone": "",
  "business_webhook": "",
  "business_email": "",
  "logo": null,
  "main_color_brand": null,
  "secondary_color_brand": null,
  "city": null,
  "state": null,
  "country": null,
  "fee_variable_saas": 0
}'
```

{% endtab %}

{% tab title="NodeJS (Axios)" %}

```javascript
const axios = require('axios');
let data = JSON.stringify({
  "phone": "",
  "first_name": "",
  "last_name": "",
  "nickname": "",
  "user_id_type": "",
  "user_id_number": "",
  "user_email": "",
  "user_id_number_dv": null,
  "type": "general",
  "business_id": "",
  "business_name": "",
  "business_id_type": "",
  "business_id_number": 1,
  "business_id_number_dv": 1,
  "business_url": "",
  "business_phone": "",
  "business_webhook": "",
  "business_email": "",
  "logo": null,
  "main_color_brand": null,
  "secondary_color_brand": null,
  "city": null,
  "state": null,
  "country": null,
  "fee_variable_saas": 0
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: `${base_url}/v1/business/child`,
  headers: { 
    'Content-Type': 'application/json', 
    'x-auth-token': token
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

{% endtab %}

{% tab title="Python" %}

```python
import requests
import json

url = f"{base_url}/v1/business/child"

payload = json.dumps({
  "phone": "",
  "first_name": "",
  "last_name": "",
  "nickname": "",
  "user_id_type": "",
  "user_id_number": "",
  "user_email": "",
  "user_id_number_dv": None,
  "type": "general",
  "business_id": "",
  "business_name": "",
  "business_id_type": "",
  "business_id_number": 1,
  "business_id_number_dv": 1,
  "business_url": "",
  "business_phone": "",
  "business_webhook": "",
  "business_email": "",
  "logo": None,
  "main_color_brand": None,
  "secondary_color_brand": None,
  "city": None,
  "state": None,
  "country": None,
  "fee_variable_saas": 0
})
headers = {
  'Content-Type': 'application/json',
  'x-auth-token': token
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.qentaz.com/documentation/cuentas-administradas/crear-cuenta-hija.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.