Blocklist clienti

​

Cosa succede quando blocchi un cliente

​

Come il blocco identifica i clienti

• 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 ID cliente potrebbe essere aggirato. Un blocco sull’email invece no.
• Gli alias sono inclusi. Le email vengono confrontate in minuscolo, rimuovendo +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 ha mai effettuato un checkout con te e non è possibile bloccare un record cliente privo di email.

​

Bloccare un cliente

​

Gestire i clienti bloccati

• Totale clienti bloccati: quanti clienti sono attualmente bloccati.
• Voci bloccate: una riga per ogni blocco, con l’Identificatore inserito (email o ID cliente), Bloccato da (il membro del team che ha aggiunto il blocco) e Bloccato il.
• Cerca identificatore e Filtri: trova una voce tramite email o ID cliente oppure filtra in base a chi l’ha bloccata e quando.
• Azione: gestisci la voce, incluso lo sblocco del cliente.

​

La pagina del cliente bloccato

• Un badge Bloccato accanto al nome del cliente e un pulsante Sblocca cliente.
• Registro attività: quando il cliente è stato aggiunto alla blocklist, il motivo ed eventuali note aggiunte in seguito dal tuo team. Fai clic su Aggiungi nota per registrare nuovo contesto, ad esempio l’esito di un chargeback. Le note possono essere modificate in seguito.
• ID di riferimento: l’ID cliente collegato a questo blocco, pronto per essere copiato.

​

Sbloccare un cliente

• Le modifiche al checkout e al Customer Portal vengono ripristinate immediatamente.
• Gli abbonamenti annullati non vengono riattivati. Il cliente deve effettuare nuovamente l’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. Verrà creata una nuova voce.

​

Cosa vede il cliente

• Durante il checkout, il pagamento non va a buon fine con un rifiuto generico: “Questo pagamento non può essere elaborato.” L’API restituisce HTTP 403 con il codice di errore PAYMENT_NOT_PERMITTED, che non specifica alcuna causa. Il motivo reale viene scritto solo nei log di Dodo Payments.
• Nel Customer Portal, tutto è visibile, ma ogni azione è disabilitata. Una richiesta di modifica bloccata restituisce PORTAL_ACTION_NOT_PERMITTED con il messaggio “Questa azione non è disponibile.” Il profilo del portale contiene read_only: true, così 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 il cliente dalla contestazione o dal pagamento e bloccalo da lì, oppure automatizza l’operazione dal webhook dispute.opened con POST /blocklist/customers. Vedi Contestazioni.
• Controlla subscriptions_swept. Quando blocchi tramite API, ripeti la chiamata finché la risposta non restituisce true, così non rimane alcun abbonamento attivo.
• Rimborsa separatamente. Un blocco impedisce solo gli acquisti futuri. Se devi del denaro al cliente, rimborsa il pagamento come di consueto.
• Controlla l’elenco. Sblocca i clienti il cui problema è stato risolto. Lo sblocco è immediato e conserva la cronologia.

​

Correlati