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: alguien@ejemplo.com

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

Respuesta

{
    "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"
}

Ejemplo

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": "pagos@tiendamaria.co",
  "logo": "https://tiendamaria.co/logo.png",
  "main_color_brand": "#FFC0CB",
  "secondary_color_brand": "#FAEBEE",
  "fee_variable_saas": 0.05,
  "fee_fixed_saas": 1000
}'

var axios = require('axios');
var data = JSON.stringify({
   "business_phone": "573111112222",
   "business_webhook": "https://trazo.co/webhook",
   "business_email": "pagos@tiendamaria.co",
   "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);
});

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": "pagos@tiendamaria.co",
   "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)

Última actualización hace 18 días