Lista de bloqueio de clientes

​

O que acontece quando você bloqueia um cliente

​

Como o bloqueio identifica os clientes

• Todos os registros com esse email são abrangidos. O Checkout pode criar um novo registro de cliente para um email que retorna, portanto um bloqueio baseado em um único customer ID poderia ser contornado. Um bloqueio baseado no email não pode.
• Os aliases são abrangidos. Os emails são comparados em letras minúsculas, com qualquer +alias removido, portanto buyer+promo@example.com e Buyer@example.com são considerados o mesmo cliente. Os pontos no endereço são mantidos como estão.
• Limitado ao seu negócio. Um bloqueio se aplica somente ao seu negócio. O mesmo email ainda pode comprar de outros negócios no Dodo Payments.
• O email deve pertencer a um cliente existente. Você não pode bloquear um email que nunca tenha feito checkout com você, e um registro de cliente sem email não pode ser bloqueado.

​

Bloqueando um cliente

​

Gerenciando clientes bloqueados

• Total Customers Blocked: Quantos clientes estão bloqueados atualmente.
• Blocked entries: Uma linha por bloqueio, com o Identifier inserido por você (email ou customer ID), Blocked By (o membro da equipe que adicionou o bloqueio) e Blocked On.
• Search Identifier e Filters: Encontre uma entrada por email ou customer ID, ou filtre por quem a bloqueou e quando.
• Action: Gerencie a entrada, incluindo desbloquear o cliente.

​

A página do cliente bloqueado

• Um selo Blocked ao lado do nome do cliente e um botão Unblock Customer.
• Activity Log: Quando o cliente foi adicionado à lista de bloqueio, o motivo e quaisquer observações adicionadas pela sua equipe desde então. Clique em Add Note para registrar um novo contexto, como o resultado de um chargeback. As observações podem ser editadas posteriormente.
• Reference IDs: O customer ID vinculado a este bloqueio, pronto para ser copiado.

​

Desbloqueando um cliente

• As alterações no Checkout e no Customer Portal são restauradas imediatamente.
• As subscriptions canceladas não são reativadas. O cliente precisa comprar novamente.
• A entrada é mantida como registro de auditoria junto com suas observações, mas não aparece mais na lista ativa.
• Você pode bloquear o mesmo cliente novamente mais tarde. Isso cria uma nova entrada.

​

O que o cliente vê

• No checkout, o pagamento falha com uma recusa genérica: “This payment cannot be processed.” A API retorna HTTP 403 com o código de erro PAYMENT_NOT_PERMITTED, que não informa nenhuma causa. O motivo real é registrado somente nos logs do Dodo Payments.
• No Customer Portal, tudo fica visível, mas todas as ações são desativadas. Uma operação de escrita bloqueada retorna PORTAL_ACTION_NOT_PERMITTED com a mensagem “This action is not available.” O perfil do portal contém read_only: true para que uma integração personalizada do portal possa desativar seus próprios controles. O portal nunca expõe a entrada da lista de bloqueio nem suas observações.

​

Usando a API

​

Bloquear um 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
}

​

Verificar se um cliente está bloqueado

​

Desbloquear um 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"

​

Práticas recomendadas

• Registre o motivo. Um motivo curto no bloqueio, junto com observações sobre tudo que acontecer depois, fornece à sua equipe de suporte o contexto completo sem sair do dashboard.
• Bloqueie após um chargeback. Abra o cliente a partir da disputa ou do pagamento e bloqueie-o ali, ou automatize isso a partir do webhook dispute.opened com POST /blocklist/customers. Consulte Disputes.
• Verifique subscriptions_swept. Ao bloquear pela API, repita a chamada até que a resposta informe true, para que nenhuma live subscription fique ativa.
• Reembolse separadamente. Um bloqueio interrompe apenas compras futuras. Se você deve dinheiro ao cliente, reembolse o pagamento normalmente.
• Revise a lista. Desbloqueie clientes cujo problema foi resolvido. O desbloqueio é imediato e mantém o histórico.

​

Relacionado