Customer Blocklist

​

What Happens When You Block a Customer

​

So werden Kunden beim Sperren abgeglichen

• Jeder Datensatz mit dieser E-Mail-Adresse ist abgedeckt. Checkout kann für eine wiederkehrende E-Mail-Adresse einen neuen Kundendatensatz erstellen, sodass eine Sperre für eine einzelne customer ID umgangen werden könnte. Eine Sperre für die E-Mail-Adresse kann nicht umgangen werden.
• Aliase sind abgedeckt. E-Mail-Adressen werden in Kleinbuchstaben verglichen, wobei +alias entfernt wird. Daher gelten buyer+promo@example.com und Buyer@example.com als derselbe Kunde. Punkte in der Adresse bleiben unverändert.
• Auf Ihr Unternehmen beschränkt. Eine Sperre gilt nur für Ihr Unternehmen. Dieselbe E-Mail-Adresse kann weiterhin bei anderen Unternehmen auf Dodo Payments einkaufen.
• Die E-Mail-Adresse muss zu einem bestehenden Kunden gehören. Sie können keine E-Mail-Adresse sperren, die zu keinem Ihrer Kunden gehört, und keinen Kundendatensatz ohne E-Mail-Adresse sperren.

​

Einen Kunden sperren

​

Blockierte Kunden verwalten

• Total Customers Blocked: Anzahl der derzeit gesperrten Kunden.
• Blocked entries: Eine Zeile pro Sperre mit dem von Ihnen eingegebenen Identifier (E-Mail-Adresse oder customer ID), Blocked By und Blocked On. Unter Blocked By wird das Teammitglied angezeigt, das die Sperre hinzugefügt hat, oder API für eine mit einem API key hinzugefügte Sperre.
• Search Identifier und Filters: Suchen Sie nach einem Eintrag anhand der E-Mail-Adresse oder customer ID oder filtern Sie nach Blocked By und Blocked Between.
• Action: See Details öffnet die Seite des blockierten Kunden, und Unblock hebt die Sperre auf. Teammitglieder mit der Rolle Viewer können keine Sperre aufheben.

​

Die Seite des blockierten Kunden

• Ein Abzeichen Blocked neben dem Namen des Kunden und eine Schaltfläche Unblock Customer.
• Activity Log: Wann der Kunde zur Blocklist hinzugefügt wurde, der Grund und alle Notizen, die Ihr Team seitdem hinzugefügt hat. Klicken Sie auf Add Note, um neuen Kontext festzuhalten, etwa das Ergebnis eines chargeback. Sie können eine Notiz später über die API bearbeiten.
• Reference IDs: Die mit dieser Sperre verknüpfte customer ID, die Sie kopieren können.

​

Die Sperre eines Kunden aufheben

• Änderungen an Checkout und Customer Portal werden sofort wiederhergestellt.
• Gekündigte Abonnements werden nicht reaktiviert. Der Kunde muss erneut einkaufen.
• Der Eintrag bleibt zusammen mit seinen Notizen als Prüfdatensatz erhalten, erscheint aber nicht mehr in der aktiven Liste.
• Sie können denselben Kunden später erneut sperren. Dadurch wird ein neuer Eintrag erstellt.

​

Was der Kunde sieht

• Beim Checkout schlägt die Zahlung mit einer allgemeinen Ablehnung fehl: “This payment cannot be processed.” Die API gibt HTTP 403 mit dem Fehlercode PAYMENT_NOT_PERMITTED zurück, der keine Ursache nennt. Der tatsächliche Grund wird nur in den Protokollen von Dodo Payments vermerkt.
• Im Customer Portal ist alles sichtbar, aber jede Aktion, die das Konto ändert, wird abgelehnt. Eine abgelehnte Aktion gibt HTTP 403 mit PORTAL_ACTION_NOT_PERMITTED und der Meldung “This action is not available.” zurück. Das Portalprofil enthält read_only: true, sodass eine benutzerdefinierte Portalintegration ihre eigenen Steuerelemente deaktivieren kann. Das Portal zeigt den Blocklist-Eintrag oder seine Notizen niemals an.

​

Die API verwenden

​

Einen Kunden sperren

import DodoPayments from 'dodopayments';

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

// Block by customer ID
const entry = await client.blocklist.customers.create({
  customer_id: 'cus_0NmichXWP8JYBB9Dw1Unj',
  reason: 'Chargeback on pay_0NmichXuYoNoapmr',
});

// Or block by email
const byEmail = await client.blocklist.customers.create({
  email: 'buyer@example.com',
  reason: 'Repeated refund abuse',
});

console.log(entry.id, entry.cancelled_subscription_ids);

import os
from dodopayments import DodoPayments

client = DodoPayments(bearer_token=os.environ["DODO_PAYMENTS_API_KEY"])

# Block by customer ID
entry = client.blocklist.customers.create(
    customer_id="cus_0NmichXWP8JYBB9Dw1Unj",
    reason="Chargeback on pay_0NmichXuYoNoapmr",
)

# Or block by email
by_email = client.blocklist.customers.create(
    email="buyer@example.com",
    reason="Repeated refund abuse",
)

print(entry.id, entry.cancelled_subscription_ids)

curl -X POST https://live.dodopayments.com/blocklist/customers \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_0NmichXWP8JYBB9Dw1Unj",
    "reason": "Chargeback on pay_0NmichXuYoNoapmr"
  }'

{
  "id": "bcu_7Hq2mV9kRt4LxYw3Pz",
  "customer_id": "cus_0NmichXWP8JYBB9Dw1Unj",
  "customer_name": "wow guy",
  "customer_email": "wowguy@example.com",
  "identifier": "cus_0NmichXWP8JYBB9Dw1Unj",
  "reason": "Chargeback on pay_0NmichXuYoNoapmr",
  "source": "api",
  "blocked_by_email": null,
  "created_at": "2026-09-02T12:09:41Z",
  "unblocked_at": null,
  "cancelled_subscription_ids": ["sub_3Fk8pW2nQs6MzXc1"],
  "subscriptions_swept": true
}

​

Prüfen, ob ein Kunde gesperrt ist

​

Die Sperre eines Kunden aufheben

await client.blocklist.customers.delete('bcu_7Hq2mV9kRt4LxYw3Pz');

client.blocklist.customers.delete("bcu_7Hq2mV9kRt4LxYw3Pz")

curl -X DELETE https://live.dodopayments.com/blocklist/customers/bcu_7Hq2mV9kRt4LxYw3Pz \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY"

​

Best Practices

• Den Grund festhalten. Ein kurzer Grund für die Sperre sowie Notizen zu späteren Ereignissen geben Ihrem Support-Team den vollständigen Kontext, ohne dass das Dashboard verlassen werden muss.
• Nach einem chargeback sperren. Öffnen Sie die Seite des Kunden über den dispute oder die Zahlung und sperren Sie ihn dort, oder automatisieren Sie dies über den dispute.opened webhook mit POST /blocklist/customers. Siehe Disputes.
• subscriptions_swept prüfen. Wenn Sie über die API sperren, wiederholen Sie den Aufruf, bis die Antwort true meldet, damit kein aktives Abonnement zurückbleibt.
• Separat erstatten. Eine Sperre verhindert nur zukünftige Käufe. Wenn Sie dem Kunden Geld schulden, erstatten Sie die Zahlung wie gewohnt.
• Die Liste überprüfen. Heben Sie die Sperre bei Kunden auf, deren Problem gelöst ist. Das Aufheben der Sperre erfolgt sofort und bewahrt den Verlauf.

​

Verwandte Themen