Lista de bloqueo de clientes

​

Qué sucede al bloquear a un cliente

​

Cómo se relaciona el bloqueo con los clientes

• Se incluyen todos los registros con ese correo electrónico. Checkout puede crear un nuevo registro de cliente para un correo que vuelve a comprar, por lo que un bloqueo de un único ID de cliente podría eludirse. Un bloqueo por correo electrónico no puede eludirse de esta forma.
• Se incluyen los alias. Los correos electrónicos se comparan en minúsculas y sin +alias, por lo que buyer+promo@example.com e Buyer@example.com se consideran el mismo cliente. Los puntos de la dirección se conservan tal como están.
• El alcance se limita a tu negocio. El bloqueo solo se aplica a tu negocio. El mismo correo electrónico puede seguir comprando a otros negocios en Dodo Payments.
• El correo electrónico debe pertenecer a un cliente existente. No puedes bloquear un correo que nunca haya completado un checkout contigo, y no se puede bloquear un registro de cliente sin correo electrónico.

​

Bloquear a un cliente

​

Gestionar clientes bloqueados

• Total Customers Blocked: Cuántos clientes están bloqueados actualmente.
• Blocked entries: Una fila por bloqueo, con el Identifier que introdujiste (correo electrónico o ID de cliente), Blocked By (el miembro del equipo que añadió el bloqueo) y Blocked On.
• Search Identifier y Filters: Busca una entrada por correo electrónico o ID de cliente, o filtra por quién la bloqueó y cuándo.
• Action: Gestiona la entrada, incluido desbloquear al cliente.

​

Página del cliente bloqueado

• Una insignia Blocked junto al nombre del cliente y un botón Unblock Customer.
• Activity Log: Cuándo se añadió el cliente a la lista de bloqueo, el motivo y las notas que tu equipo haya añadido posteriormente. Haz clic en Add Note para registrar información adicional, como el resultado de un contracargo. Las notas se pueden editar más adelante.
• Reference IDs: El ID de cliente vinculado a este bloqueo, listo para copiar.

​

Desbloquear a un cliente

• Checkout y los cambios en Customer Portal se restablecen de inmediato.
• Las suscripciones canceladas no se reactivan. El cliente debe volver a comprar.
• La entrada se conserva como registro de auditoría junto con sus notas, pero ya no aparece en la lista activa.
• Puedes volver a bloquear al mismo cliente más adelante. Esto crea una nueva entrada.

​

Qué ve el cliente

• En Checkout, el pago falla con un rechazo genérico: “This payment cannot be processed.” La API devuelve HTTP 403 con el código de error PAYMENT_NOT_PERMITTED, que no indica ninguna causa. El motivo real solo se registra en los logs de Dodo Payments.
• En Customer Portal, todo es visible, pero todas las acciones están deshabilitadas. Una escritura bloqueada devuelve PORTAL_ACTION_NOT_PERMITTED con el mensaje “This action is not available.” El perfil del portal incluye read_only: true para que una integración personalizada del portal pueda deshabilitar sus propios controles. El portal nunca muestra la entrada de la lista de bloqueo ni sus notas.

​

Usar la API

​

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

​

Comprobar si un cliente está bloqueado

​

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

​

Prácticas recomendadas

• Registra el motivo. Un motivo breve en el bloqueo, junto con notas sobre lo que ocurra después, proporciona a tu equipo de soporte toda la información sin salir del dashboard.
• Bloquea después de un contracargo. Abre el cliente desde la disputa o el pago y bloquéalo allí, o automatiza el proceso desde el webhook dispute.opened con POST /blocklist/customers. Consulta Disputas.
• Comprueba subscriptions_swept. Cuando bloquees mediante la API, repite la llamada hasta que la respuesta indique true, para que no quede ninguna suscripción activa.
• Reembolsa por separado. Un bloqueo solo detiene compras futuras. Si debes dinero al cliente, reembolsa el pago como de costumbre.
• Revisa la lista. Desbloquea a los clientes cuyo problema se haya resuelto. El desbloqueo es inmediato y conserva el historial.

​

Relacionado