Liste de blocage des clients

​

Ce qui se passe lorsque vous bloquez un client

​

Comment le blocage identifie les clients

• Toutes les fiches associées à cette adresse sont concernées. Checkout peut créer une nouvelle fiche client pour une adresse e-mail déjà utilisée. Un blocage basé sur un seul customer ID pourrait donc être contourné, contrairement à un blocage basé sur l’adresse e-mail.
• Les alias sont pris en compte. Les adresses e-mail sont comparées en minuscules, après suppression de +alias. Ainsi, buyer+promo@example.com et Buyer@example.com correspondent au même client. Les points présents dans l’adresse sont conservés.
• Le blocage est limité à votre entreprise. Un blocage s’applique uniquement à votre entreprise. La même adresse e-mail peut toujours acheter auprès d’autres entreprises sur Dodo Payments.
• L’adresse e-mail doit appartenir à un client existant. Vous ne pouvez pas bloquer une adresse e-mail qui n’a jamais effectué de Checkout chez vous, ni une fiche client dépourvue d’adresse e-mail.

​

Bloquer un client

​

Gérer les clients bloqués

• Total Customers Blocked : nombre de clients actuellement bloqués.
• Blocked entries : une ligne par blocage, avec l’Identifier saisi (adresse e-mail ou customer ID), Blocked By (le membre de l’équipe ayant ajouté le blocage) et Blocked On.
• Search Identifier et Filters : recherchez une entrée par adresse e-mail ou customer ID, ou filtrez selon l’auteur et la date du blocage.
• Action : gérez l’entrée, notamment en débloquant le client.

​

Page du client bloqué

• Un badge Blocked à côté du nom du client et un bouton Unblock Customer.
• Activity Log : la date à laquelle le client a été ajouté à la liste de blocage, le motif et les notes ajoutées depuis par votre équipe. Cliquez sur Add Note pour consigner un nouveau contexte, comme l’issue d’une rétrofacturation. Les notes peuvent être modifiées ultérieurement.
• Reference IDs : le customer ID associé à ce blocage, prêt à être copié.

​

Débloquer un client

• Les modifications dans Checkout et le Customer Portal sont immédiatement rétablies.
• Les abonnements annulés ne sont pas réactivés. Le client doit effectuer un nouvel achat.
• L’entrée est conservée comme trace d’audit avec ses notes, mais n’apparaît plus dans la liste active.
• Vous pouvez à nouveau bloquer le même client ultérieurement. Cela crée une nouvelle entrée.

​

Ce que voit le client

• Lors du Checkout, le paiement échoue avec un refus générique : “This payment cannot be processed.” L’API renvoie HTTP 403 avec le code d’erreur PAYMENT_NOT_PERMITTED, qui ne précise aucune cause. Le véritable motif est consigné uniquement dans les logs de Dodo Payments.
• Dans le Customer Portal, tout reste visible, mais chaque action est désactivée. Une opération d’écriture bloquée renvoie PORTAL_ACTION_NOT_PERMITTED avec le message “This action is not available.” Le profil du portail contient read_only: true afin qu’une intégration de portail personnalisée puisse désactiver ses propres contrôles. Le portail n’expose jamais l’entrée de la liste de blocage ni ses notes.

​

Utiliser l’API

​

Bloquer un client

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
}

​

Vérifier si un client est bloqué

​

Débloquer un client

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"

​

Bonnes pratiques

• Consignez le motif. Un motif court sur le blocage, complété par des notes pour les événements ultérieurs, permet à votre équipe d’assistance de disposer de tout le contexte sans quitter le dashboard.
• Bloquez après une rétrofacturation. Ouvrez le client depuis le litige ou le paiement et bloquez-le à cet endroit, ou automatisez l’opération depuis le webhook dispute.opened avec POST /blocklist/customers. Consultez la page Disputes.
• Vérifiez subscriptions_swept. Lorsque vous bloquez un client via l’API, répétez l’appel jusqu’à ce que la réponse indique true, afin qu’aucun abonnement actif ne subsiste.
• Remboursez séparément. Un blocage empêche uniquement les achats futurs. Si vous devez de l’argent au client, remboursez le paiement comme d’habitude.
• Consultez la liste. Débloquez les clients dont le problème est résolu. Le déblocage est immédiat et conserve l’historique.

​

Contenu associé