Kundblocklista

​

Vad händer när du blockerar en kund

​

Så matchar blockeringen kunder

• Alla poster med den e-postadressen omfattas. Checkout kan skapa en ny kundpost för en återkommande e-postadress, så en blockering av ett enda customer ID skulle kunna kringgås. Det går inte med en blockering av e-postadressen.
• Alias omfattas. E-postadresser jämförs med gemener och med eventuell +alias borttagen, så buyer+promo@example.com och Buyer@example.com räknas som samma kund. Punkter i adressen behålls som de är.
• Gäller endast ditt företag. En blockering gäller endast ditt företag. Samma e-postadress kan fortfarande handla från andra företag på Dodo Payments.
• E-postadressen måste tillhöra en befintlig kund. Du kan inte blockera en e-postadress som inte matchar någon av dina kunder, och du kan inte blockera en kundpost som saknar e-postadress.

​

Blockera en kund

​

Hantera blockerade kunder

• Total Customers Blocked: Hur många kunder som för närvarande är blockerade.
• Blocked entries: En rad per blockering, med det Identifier du angav (e-postadress eller customer ID), Blocked By och Blocked On. Blocked By visar den teammedlem som lade till blockeringen, eller API för en blockering som lagts till med en API-nyckel.
• Search Identifier och Filters: Hitta en post med e-postadress eller customer ID, eller filtrera efter Blocked By och Blocked Between.
• Action: See Details öppnar den blockerade kundens sida och Unblock tar bort blockeringen. Teammedlemmar med rollen Viewer kan inte häva en blockering.

​

Den blockerade kundens sida

• En Blocked-etikett bredvid kundens namn och en knapp för Unblock Customer.
• Activity Log: När kunden lades till i blocklistan, orsaken och eventuella anteckningar som ditt team har lagt till sedan dess. Klicka på Add Note för att dokumentera ny information, till exempel resultatet av en chargeback. Du kan senare redigera en anteckning via API.
• Reference IDs: Kundens ID som är kopplat till denna blockering och kan kopieras.

​

Häva en blockering

• Ändringar i Checkout och Customer Portal återställs omedelbart.
• Avslutade prenumerationer återaktiveras inte. Kunden måste köpa igen.
• Posten behålls som en granskningspost tillsammans med sina anteckningar, men visas inte längre i den aktiva listan.
• Du kan blockera samma kund igen senare. Det skapar en ny post.

​

Vad kunden ser

• I Checkout misslyckas betalningen med ett generiskt avslag: “This payment cannot be processed.” API returnerar HTTP 403 med felkoden PAYMENT_NOT_PERMITTED, som inte anger någon orsak. Den verkliga orsaken skrivs endast till Dodo Payments loggar.
• I Customer Portal är allt synligt, men varje åtgärd som ändrar kontot nekas. En nekad åtgärd returnerar HTTP 403 med PORTAL_ACTION_NOT_PERMITTED och meddelandet “This action is not available.” Portalprofilen innehåller read_only: true, så en anpassad portalintegration kan inaktivera sina egna kontroller. Portalen visar aldrig blocklistposten eller dess anteckningar.

​

Använda API

​

Blockera en kund

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
}

​

Kontrollera om en kund är blockerad

​

Häva en blockering för en kund

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"

​

Bästa praxis

• Dokumentera orsaken. En kort orsak på blockeringen, tillsammans med anteckningar om sådant som händer senare, ger ditt supportteam hela bilden utan att behöva lämna dashboarden.
• Blockera efter en chargeback. Öppna kundens sida från tvisten eller betalningen och blockera kunden där, eller automatisera det från webhooken dispute.opened med POST /blocklist/customers. Se Disputes.
• Kontrollera subscriptions_swept. När du blockerar via API ska du upprepa anropet tills svaret rapporterar true, så att ingen aktiv prenumeration lämnas kvar.
• Återbetala separat. En blockering stoppar endast framtida köp. Om du är skyldig kunden pengar återbetalar du betalningen som vanligt.
• Granska listan. Häv blockeringar för kunder vars problem är löst. Att häva en blockering sker omedelbart och historiken bevaras.

​

Relaterat