Configuración de Múltiples Marcas

​

Introducción

​

Flujo del Merchant Dashboard

1

Open Settings → Business

Ve a Settings → Business. El panel Brands Under [Your Business] muestra tu Primary Brand y las Secondary Brands.

2

Click the + Button

En el panel Brands, haz clic en el botón + de la esquina superior derecha para abrir el formulario de nueva marca.

3

Fill In the Brand Details

Completa los siguientes campos:

• Brand Name (obligatorio): Al menos 2 caracteres y diferente de los nombres de tus otras marcas.
• Support Email: La dirección que usan los clientes para ponerse en contacto con el soporte de esta marca.
• Brand Description (obligatorio): Al menos 10 caracteres. Describe la marca, sus productos y qué la distingue.
• Brand Logo: Representa la marca en el checkout, las facturas y los enlaces de pago. Los formatos aceptados son PNG, JPEG, GIF, WebP, ICO y SVG. Cualquier otro formato se rechaza con un error 422.

Haz clic en Add brand para crear la marca. Después puedes asignarle productos, y sus enlaces de pago mostrarán su identidad de marca. Para establecer el descriptor del extracto o cambiar otros detalles más adelante, abre el menú ... de la marca y selecciona Edit.

4

Select the Brand on Products

Cuando crees un producto, elige su marca en el campo Brand.

5

Find the Brand ID in Transactions

Las transacciones y suscripciones muestran un Brand ID, para que puedas saber a qué marca pertenece cada una.

​

Puntos adicionales

• Sin cambios en los pagos: Los fondos, los ciclos de pago y las tarifas se mantienen en el nivel del negocio y se transfieren a la billetera del negocio y a tu cuenta bancaria.
• ID de marca en los webhooks: Los payloads de pagos, suscripciones, reembolsos, claves de licencia, entradas del libro mayor de créditos, saldos de crédito bajos, concesiones de derechos, intentos de cobro y checkouts abandonados incluyen un brand_id, para que puedas atribuir cada evento a una marca. Cuando una entidad no tiene una marca propia, brand_id es la marca principal del negocio. Los payloads de disputas no incluyen brand_id, así que usa su payment_id para encontrar la marca asociada al pago. Los payloads de pagos son de nivel empresarial y no incluyen brand_id.
• Suspensiones: Si una marca se suspende, no puede aceptar nuevos pagos, sesiones de checkout ni suscripciones. Las demás marcas del mismo negocio pueden seguir realizando transacciones.
• Facturas: Cada factura muestra el nombre y el logotipo de la marca a la que pertenece el pago.
• Storefront, las claves de licencia, los códigos de descuento, la configuración de pagos y otras funciones de nivel empresarial funcionan igual que con una sola marca.

​

Archivar una marca

​

Archivar una marca desde el Dashboard

1

Open the Brand's Actions Menu

Ve a Settings → Business. En el panel Brands Under [Your Business], abre el menú ... situado junto a la marca secundaria y selecciona Archive. La marca principal no tiene la opción Archive.

2

Confirm the Archive

Lee la advertencia y selecciona Continue.

3

Choose the Brand That Takes Over

En Move products to, selecciona la marca que recibirá los productos, las suscripciones activas y las colecciones. La marca principal es la opción predeterminada. Selecciona Move & Archive para trasladar los registros y archivar la marca en una sola acción.

4

Check the Result

La confirmación indica el nombre de la marca que recibió los registros.

La marca archivada desaparece del panel Brands. Cuando la empresa no tiene ninguna otra marca secundaria, el grupo Secondary Brands también desaparece.

​

Qué sucede al archivar

• Traslada todos los productos a la marca de destino.
• Traslada todas las suscripciones activas a la marca de destino, de modo que las renovaciones se facturen bajo ella.
• Traslada todas las colecciones de productos a la marca de destino.
• Archiva y deshabilita la marca original.

​

Una marca archivada es de solo lectura

​

Archivar mediante la API

import DodoPayments from 'dodopayments';

const client = new DodoPayments({ bearerToken: process.env.DODO_PAYMENTS_API_KEY });

const response = await client.brands.archive('brnd_8dFiAW42v28JzhlVSocjq', {
  move_products_to: 'brnd_pRQ2zXk91mNvBcTgLwHsA',
});

console.log(response.products_moved);

import os
from dodopayments import DodoPayments

client = DodoPayments(bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"))

response = client.brands.archive(
    id="brnd_8dFiAW42v28JzhlVSocjq",
    move_products_to="brnd_pRQ2zXk91mNvBcTgLwHsA",
)
print(response.products_moved)

curl -X POST https://live.dodopayments.com/brands/brnd_8dFiAW42v28JzhlVSocjq/archive \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"move_products_to": "brnd_pRQ2zXk91mNvBcTgLwHsA"}'

{
  "brand_id": "brnd_8dFiAW42v28JzhlVSocjq",
  "archived_at": "2026-08-17T11:20:05Z",
  "moved_to_brand_id": "brnd_pRQ2zXk91mNvBcTgLwHsA",
  "products_moved": 12,
  "subscriptions_moved": 3,
  "collections_moved": 1
}

curl "https://live.dodopayments.com/brands?include_archived=true" \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY"