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 recorrente, 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 à sua empresa. Um bloqueio se aplica apenas à sua empresa. O mesmo email ainda pode comprar de outras empresas no Dodo Payments.
• O email deve pertencer a um cliente existente. Você não pode bloquear um email que não corresponda a nenhum dos seus clientes, nem pode bloquear um registro de cliente sem email.

​

Bloqueando um cliente

​

Gerenciando clientes bloqueados

• Total Customers Blocked: Quantos clientes estão bloqueados no momento.
• Blocked entries: Uma linha por bloqueio, com o Identifier inserido (email ou customer ID), Blocked By e Blocked On. Blocked By mostra o membro da equipe que adicionou o bloqueio ou API para um bloqueio adicionado com uma API key.
• Search Identifier e Filters: Encontre uma entrada por email ou customer ID, ou filtre por Blocked By e Blocked Between.
• Action: See Details abre a página do cliente bloqueado, e Unblock remove o bloqueio. Membros da equipe com a função Viewer não podem desbloquear.

​

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 notas adicionadas pela sua equipe desde então. Clique em Add Note para registrar um novo contexto, como o resultado de um chargeback. Você pode editar uma nota posteriormente pela API.
• 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.
• Assinaturas canceladas não são reativadas. O cliente precisa fazer uma nova compra.
• A entrada é mantida como registro de auditoria junto com suas notas, mas não aparece mais na lista de ativos.
• 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 apenas nos logs do Dodo Payments.
• No Customer Portal, tudo fica visível, mas toda ação que altera a conta é recusada. Uma ação recusada retorna HTTP 403 com PORTAL_ACTION_NOT_PERMITTED e a mensagem “This action is not available.” O perfil do portal contém read_only: true, portanto uma integração personalizada do portal pode desativar seus próprios controles. O portal nunca expõe a entrada da lista de bloqueio nem suas notas.

​

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
}

​

Verificando se um cliente está bloqueado

​

Desbloqueando 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 notas sobre o que acontecer depois, fornece à sua equipe de suporte o contexto completo sem sair do dashboard.
• Bloqueie após um chargeback. Abra a página do cliente pela disputa ou pelo pagamento e bloqueie-o ali, ou automatize o processo pelo 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 assinatura ativa permaneça.
• 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