Actualizar cuenta administrada

Este endpoint permite actualizar la información de perfil, configuraciones de marca (branding), URLs de webhooks y comisiones de SaaS (fees) de un negocio hijo/cuenta administrada existente. El endpoint requiere especificar el identificador único del negocio en la ruta y validar que exista una relación comercial (padre-hijo).

Ruta

PATCH /v1/business/child/:business_id

Encabezado

Name	Value
Content-Type*	application/json
x-auth-token*	{token}

Parámetros de ruta

Name	Value
business_id*	El business_id de la cuenta administrada (negocio hijo) que se desea actualizar.

Cuerpo

Datos del Negocio

Name	Type	Description
business_phone	string	Número de celular del negocio. Ejemplo: 573112229999
business_email	string	Correo electrónico de contacto comercial del sub-negocio. Ejemplo: [e-mail]
business_webhook	string	URL del webhook donde el sub-negocio recibirá los eventos de notificación. Ejemplo:https://minegocio.com/mi-aplicacion

Apariencia y Ubicación

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

Name	Type	Description
logo	string	URL (URI válida) con la imagen del logo del sub-negocio.
main_color_brand	string	Código HEX del color principal de la marca Ejemplo #FF0000
secondary_color_brand	string	Código HEX del color secundario de la marca. Ejemplo #FF0000

Configuración Financiera

Name	Type	Description
fee_variable_saas	number	Tarifa (fee) variable aplicada bajo el modelo SaaS para este sub-negocio específico. Se espera un número entre 0 y 1(por defecto es 0 Ejemplo: 0.1
fee_fixed_saas	number	Tarifa (fee) fija aplicada bajo el modelo SaaS para este sub-negocio específico. Ejemplo: 2000

Configuración Medios de Pago

Name	Type	Description
payment_methods.breb	boolean	Habilita los pagos mediante Bre-B.
payment_methods.wallet	boolean	Habilita los pagos mediante billetera digital.
payment_methods.bank	boolean	Habilita los pagos mediante transferencia bancaria.
payment_methods.card	boolean	Habilita los pagos con tarjeta nacional.
payment_methods.card_intl	boolean	Habilita los pagos con tarjeta internacional.
payment_methods.card_by_tz	boolean	Habilita los pagos con tarjeta mediante zona tarifaria.
payment_methods.cash	boolean	Habilita los pagos en efectivo.

Respuesta

200

{
    "message": "Child Business actualizado exitosamente ✅",
    "business_id": "pruebachild",
    "updated_fields": {
        "business": [
            "business_phone",
            "business_email",
            "business_webhook",
            "logo",
            "main_color_brand",
            "secondary_color_brand",
            "fee_variable_saas",
            "fee_fixed_saas"
        ]
    },
    "updated_at": "2026-05-20T17:27:10-05:00"
}

400

{
    "error": [
        "\"logo\" must be a url"
    ]
}

401

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

---

Ejemplo

cURL

curl --location --request PATCH '{{base_url}}/v1/business/child/pruebachild' \
--header 'x-auth-token: token' \
--header 'Content-Type: application/json' \
--data-raw '{
  "business_phone": "573111112222",
  "business_webhook": "https://trazo.co/webhook",
  "business_email": "[e-mail]",
  "logo": "https://tiendamaria.co/logo.png",
  "main_color_brand": "#FFC0CB",
  "secondary_color_brand": "#FAEBEE",
  "fee_variable_saas": 0.05,
  "fee_fixed_saas": 1000
}'

NodeJS (Axios)

var axios = require('axios');
var data = JSON.stringify({
   "business_phone": "573111112222",
   "business_webhook": "https://trazo.co/webhook",
   "business_email": "[e-mail]",
   "logo": "https://tiendamaria.co/logo.png",
   "main_color_brand": "#FFC0CB",
   "secondary_color_brand": "#FAEBEE",
   "fee_variable_saas": 0.05,
   "fee_fixed_saas": 1000
});

var config = {
   method: 'patch',
   url: `${base_url}/v1/business/child/pruebachild`,
   headers: { 
      'x-auth-token': token, 
      'Content-Type': 'application/json'
   },
   data : data
};

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

Python

import requests
import json

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

payload = json.dumps({
   "business_phone": "573111112222",
   "business_webhook": "https://trazo.co/webhook",
   "business_email": "[e-mail]",
   "logo": "https://tiendamaria.co/logo.png",
   "main_color_brand": "#FFC0CB",
   "secondary_color_brand": "#FAEBEE",
   "fee_variable_saas": 0.05,
   "fee_fixed_saas": 1000
})
headers = {
   'x-auth-token': token,
   'Content-Type': 'application/json'
}

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

print(response.text)