Multi-Brand Setup

​

Einführung

​

Ablauf im Merchant Dashboard

1

Open Settings → Business

Gehen Sie zu Settings → Business. Das Panel Brands Under [Your Business] listet Ihre Primary Brand und alle Secondary Brands auf.

2

Click the + Button

Klicken Sie im Panel „Brands“ oben rechts auf die Schaltfläche +, um das Formular für eine neue Marke zu öffnen.

3

Fill In the Brand Details

Füllen Sie die folgenden Felder aus:

• Brand Name (erforderlich): Mindestens 2 Zeichen und abweichend von den Namen Ihrer anderen Marken.
• Support Email: Die Adresse, über die Kunden den Support für diese Marke kontaktieren.
• Brand Description (erforderlich): Mindestens 10 Zeichen. Beschreiben Sie die Marke, ihre Produkte und was sie von anderen unterscheidet.
• Brand Logo: Repräsentiert die Marke auf der Checkout-Seite, auf Rechnungen und auf Zahlungslinks. Akzeptierte Formate sind PNG, JPEG, GIF, WebP, ICO und SVG. Jedes andere Format wird mit einem 422-Fehler abgelehnt.

Klicken Sie auf Add brand, um die Marke zu erstellen. Anschließend können Sie ihr Produkte zuweisen, und ihre Zahlungslinks zeigen ihr Branding. Um den Abrechnungstext festzulegen oder später andere Details zu ändern, öffnen Sie das ...-Menü der Marke und wählen Sie Edit.

4

Select the Brand on Products

Beim Erstellen eines Produkts wählen Sie dessen Marke im Feld Brand aus.

5

Find the Brand ID in Transactions

Transaktionen und Abonnements zeigen eine Brand ID, sodass Sie erkennen können, zu welcher Marke sie gehören.

​

Zusätzliche Hinweise

• Keine Änderungen bei Auszahlungen: Gelder, Auszahlungszyklen und Gebühren bleiben auf Unternehmensebene und fließen in das Wallet des Unternehmens und auf Ihr Bankkonto.
• Marken-ID in Webhooks: Zahlungs-, Abonnement-, Rückerstattungs-, Lizenzschlüssel-, Kreditleger-Eintrags-, „Kreditguthaben niedrig“-, Berechtigungsvergabe-, Mahnversuchs- und abgebrochene Checkout-Payloads enthalten eine brand_id, sodass Sie jedes Ereignis einer Marke zuordnen können. Wenn eine Entität keine eigene Marke hat, ist brand_id die primäre Marke des Unternehmens. Dispute-Payloads enthalten keine brand_id. Verwenden Sie daher deren payment_id, um die Marke der Zahlung zu ermitteln. Auszahlungs-Payloads gelten auf Unternehmensebene und enthalten keine brand_id.
• Sperrungen: Wenn eine Marke gesperrt wird, kann sie keine neuen Zahlungen, Checkout-Sitzungen oder Abonnements annehmen. Andere Marken desselben Unternehmens können weiterhin Transaktionen durchführen.
• Rechnungen: Jede Rechnung zeigt den Namen und das Logo der Marke, zu der die Zahlung gehört.
• Storefront, Lizenzschlüssel, Rabattcodes, Auszahlungseinstellungen und andere Funktionen auf Unternehmensebene funktionieren genauso wie bei einer einzelnen Marke.

​

Eine Marke archivieren

​

Eine Marke über das Dashboard archivieren

1

Open the Brand's Actions Menu

Gehen Sie zu Settings → Business. Öffnen Sie im Panel Brands Under [Your Business] das ...-Menü neben der sekundären Marke und wählen Sie Archive. Für die primäre Marke gibt es keine Option Archive.

2

Confirm the Archive

Lesen Sie den Warnhinweis und wählen Sie Continue.

3

Choose the Brand That Takes Over

Wählen Sie unter Move products to die Marke aus, die die Produkte, aktiven Abonnements und Sammlungen übernimmt. Die primäre Marke ist standardmäßig ausgewählt. Wählen Sie Move & Archive, um die Datensätze zu verschieben und die Marke in einem Schritt zu archivieren.

4

Check the Result

Die Bestätigung nennt die Marke, die die Datensätze übernommen hat.

Die archivierte Marke wird aus dem Panel „Brands“ entfernt. Wenn das Unternehmen keine weitere sekundäre Marke hat, wird auch die Gruppe Secondary Brands entfernt.

​

Was beim Archivieren geschieht

• Verschiebt jedes Produkt zur Zielmarke.
• Verschiebt jedes aktive Abonnement zur Zielmarke, sodass Verlängerungen über diese Marke abgerechnet werden.
• Verschiebt jede Produktsammlung zur Zielmarke.
• Archiviert und deaktiviert die ursprüngliche Marke.

​

Eine archivierte Marke ist schreibgeschützt

​

Über die API archivieren

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"