客户阻止列表

​

阻止客户后会发生什么

​

阻止如何匹配客户

• 该 email 对应的每条记录都会受到影响。 Checkout 可以为回访客户的 email 创建新的客户记录，因此仅阻止单个 customer ID 可能会被绕过，而按 email 阻止则不会。
• 别名也会受到影响。 系统会将 email 转为小写，并移除其中的 +alias，因此 buyer+promo@example.com 和 Buyer@example.com 会被视为同一客户。地址中的点号会保持不变。
• 仅限您的业务。 阻止仅适用于您的业务。同一 email 仍可在 Dodo Payments 上向其他业务购买商品。
• email 必须属于现有客户。 如果 email 与您的任何客户都不匹配，您无法阻止该 email；如果客户记录没有 email，也无法阻止该客户记录。

​

阻止客户

​

管理被阻止的客户

• Total Customers Blocked：当前被阻止的客户数量。
• Blocked entries：每个阻止对应一行，其中包含您输入的 Identifier（email 或 customer ID）、Blocked By 和 Blocked On。Blocked By 显示添加阻止的团队成员；如果通过 API key 添加，则显示 API。
• Search Identifier 和 Filters：按 email 或 customer ID 查找条目，或按 Blocked By 和 Blocked Between 筛选。
• Action：See Details 打开被阻止客户的页面，Unblock 移除阻止。具有 Viewer 角色的团队成员无法解除阻止。

​

被阻止客户的页面

• 客户姓名旁的 Blocked 徽章，以及 Unblock Customer 按钮。
• Activity Log：客户被添加到阻止名单的时间、原因，以及团队之后添加的任何备注。点击 Add Note 记录新的上下文，例如拒付的处理结果。之后可以通过 API 编辑备注。
• Reference IDs：与此阻止关联的 customer ID，可直接复制。

​

解除阻止客户

• Checkout 和 Customer Portal 的更改会立即恢复。
• 已取消的订阅不会重新激活。 客户必须重新购买。
• 该条目会与备注一起保留为审计记录，但不再显示在有效列表中。
• 之后可以再次阻止同一客户。这会创建一个新条目。

​

客户看到的内容

• 在 checkout 中，付款会以通用拒付信息失败：“This payment cannot be processed.” API 会返回包含错误代码 PAYMENT_NOT_PERMITTED 的 HTTP 403，其中不会说明原因。实际原因仅会写入 Dodo Payments 的日志。
• 在 Customer Portal 中，所有内容仍可见，但所有会更改账户的操作都会被拒绝。被拒绝的操作会返回带有 PORTAL_ACTION_NOT_PERMITTED 和消息 “This action is not available.” 的 HTTP 403。portal profile 会携带 read_only: true，因此自定义 portal 集成可以禁用自身控件。portal 永远不会暴露阻止名单条目或其备注。

​

使用 API

​

阻止客户

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
}

​

检查客户是否被阻止

​

解除对客户的阻止

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"

​

最佳实践

• 记录原因。 在阻止中记录简短原因，并为之后发生的任何情况添加备注，可以让支持团队了解完整经过，而无需离开 dashboard。
• 拒付后进行阻止。 从争议或付款页面打开客户页面并在那里阻止客户，或通过 dispute.opened webhook 和 POST /blocklist/customers 自动执行。请参阅 Disputes。
• 检查 subscriptions_swept。 通过 API 阻止客户时，重复调用，直到响应报告 true，确保没有遗留有效订阅。
• 单独退款。 阻止只会停止未来购买。如果您需要向客户退款，请照常退还付款。
• 检查列表。 对问题已解决的客户解除阻止。解除阻止会立即生效，同时保留历史记录。

​

相关内容