Liste de blocage des clients

​

Ce qui se passe lorsque vous bloquez un client

​

Comment le blocage identifie les clients

• Toutes les fiches utilisant cette adresse e-mail sont concernées. Checkout peut créer une nouvelle fiche client pour une adresse e-mail réutilisée ; un blocage basé sur un seul customer ID pourrait donc être contourné. Ce n’est pas possible avec un blocage basé sur l’adresse e-mail.
• Les alias sont concernés. Les adresses e-mail sont comparées en minuscules, après suppression de +alias. Ainsi, buyer+promo@example.com et Buyer@example.com désignent le même client. Les points présents dans l’adresse sont conservés.
• Le blocage est limité à votre entreprise. Il 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 ne correspond à aucun de vos clients, ni une fiche client qui ne contient aucune 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 et Blocked On. Blocked By indique le membre de l’équipe qui a ajouté le blocage, ou API pour un blocage ajouté avec une clé API.
• Search Identifier et Filters : recherchez une entrée par adresse e-mail ou customer ID, ou filtrez par Blocked By et Blocked Between.
• Action : See Details ouvre la page du client bloqué et Unblock supprime le blocage. Les membres de l’équipe ayant le rôle Viewer ne peuvent pas débloquer un client.

​

Page du client bloqué

• Un badge Blocked à côté du nom du client et un bouton Unblock Customer.
• Activity Log : la date d’ajout du client à la liste de blocage, le motif et les notes ajoutées depuis par votre équipe. Cliquez sur Add Note pour enregistrer de nouveaux éléments, comme l’issue d’une contestation de paiement. Vous pouvez modifier une note ultérieurement via l’API.
• Reference IDs : le customer ID associé à ce blocage, prêt à être copié.

​

Débloquer un client

• Les modifications de Checkout et du Customer Portal sont restaurées immédiatement.
• 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 bloquer à nouveau 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 n’indique aucun motif. Le véritable motif est uniquement enregistré dans les logs de Dodo Payments.
• Dans le Customer Portal, tout reste visible, mais toute action qui modifie le compte est refusée. Une action refusée renvoie HTTP 403 avec PORTAL_ACTION_NOT_PERMITTED et le message “This action is not available.” Le profil du portail contient read_only: true, ce qui permet à une intégration de portail personnalisée de 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

• Indiquez 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 contestation de paiement. Ouvrez la page du client depuis le litige ou le paiement et bloquez-le depuis cette page, 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é