Blocklist clienti

​

Cosa succede quando blocchi un cliente

​

Come vengono associati i clienti ai blocchi

• Sono inclusi tutti i record con quell’email. Il Checkout può creare un nuovo record cliente per un’email già utilizzata, quindi un blocco su un singolo customer ID potrebbe essere aggirato. Un blocco sull’email no.
• Gli alias sono inclusi. Le email vengono confrontate in minuscolo dopo aver rimosso +alias, quindi buyer+promo@example.com e Buyer@example.com vengono considerati lo stesso cliente. I punti nell’indirizzo vengono mantenuti così come sono.
• Limitato alla tua attività. Un blocco si applica solo alla tua attività. La stessa email può ancora acquistare da altre attività su Dodo Payments.
• L’email deve appartenere a un cliente esistente. Non puoi bloccare un’email che non corrisponde a nessuno dei tuoi clienti e non puoi bloccare un record cliente privo di email.

​

Bloccare un cliente

​

Gestire i clienti bloccati

• Total Customers Blocked: il numero di clienti attualmente bloccati.
• Blocked entries: una riga per ogni blocco, con l’Identifier inserito (email o customer ID), Blocked By e Blocked On. Blocked By mostra il membro del team che ha aggiunto il blocco oppure API per un blocco aggiunto con una API key.
• Search Identifier e Filters: trova una voce tramite email o customer ID oppure filtra per Blocked By e Blocked Between.
• Action: See Details apre la pagina del cliente bloccato e Unblock rimuove il blocco. I membri del team con il ruolo Viewer non possono rimuovere un blocco.

​

La pagina del cliente bloccato

• Un badge Blocked accanto al nome del cliente e un pulsante Unblock Customer.
• Activity Log: quando il cliente è stato aggiunto alla blocklist, il motivo e le eventuali note aggiunte successivamente dal team. Fai clic su Add Note per registrare nuovo contesto, ad esempio l’esito di un chargeback. Puoi modificare una nota in un secondo momento tramite l’API.
• Reference IDs: il customer ID collegato a questo blocco, pronto per essere copiato.

​

Sbloccare un cliente

• Le modifiche a Checkout e Customer Portal vengono ripristinate immediatamente.
• Le sottoscrizioni cancellate non vengono riattivate. Il cliente deve effettuare un nuovo acquisto.
• La voce viene conservata come record di audit insieme alle relative note, ma non appare più nell’elenco attivo.
• Puoi bloccare nuovamente lo stesso cliente in seguito. In questo caso viene creata una nuova voce.

​

Cosa vede il cliente

• Al Checkout, il pagamento non va a buon fine con un rifiuto generico: “This payment cannot be processed.” L’API restituisce HTTP 403 con il codice di errore PAYMENT_NOT_PERMITTED, che non indica alcuna causa. Il motivo reale viene registrato solo nei log di Dodo Payments.
• Nel Customer Portal, tutto è visibile, ma ogni azione che modifica l’account viene rifiutata. Un’azione rifiutata restituisce HTTP 403 con PORTAL_ACTION_NOT_PERMITTED e il messaggio “This action is not available.” Il profilo del portale include read_only: true, quindi un’integrazione personalizzata del portale può disabilitare i propri controlli. Il portale non mostra mai la voce della blocklist né le relative note.

​

Utilizzare l’API

​

Bloccare un cliente

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
}

​

Verificare se un cliente è bloccato

​

Sbloccare un cliente

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 practice

• Registra il motivo. Un breve motivo sul blocco, insieme alle note per qualsiasi evento successivo, fornisce al team di supporto il quadro completo senza dover uscire dalla dashboard.
• Blocca dopo un chargeback. Apri la pagina del cliente dalla contestazione o dal pagamento e bloccala da lì, oppure automatizza l’operazione dal webhook dispute.opened con POST /blocklist/customers. Consulta Disputes.
• Controlla subscriptions_swept. Quando blocchi tramite l’API, ripeti la chiamata finché la risposta non restituisce true, così non rimane alcuna sottoscrizione attiva.
• Rimborsa separatamente. Un blocco impedisce solo gli acquisti futuri. Se devi del denaro al cliente, rimborsa il pagamento come di consueto.
• Esamina l’elenco. Sblocca i clienti il cui problema è stato risolto. Lo sblocco è immediato e conserva la cronologia.

​

Correlati