Danh sách chặn khách hàng

​

Điều gì xảy ra khi bạn chặn một khách hàng

​

Cách việc chặn khớp với khách hàng

• Mọi bản ghi có email đó đều bị áp dụng. Checkout có thể tạo bản ghi khách hàng mới cho email quay lại, vì vậy việc chặn một customer ID duy nhất có thể bị vượt qua. Việc chặn theo email thì không.
• Các bí danh cũng được áp dụng. Email được so sánh ở dạng chữ thường sau khi xóa +alias, vì vậy buyer+promo@example.com và Buyer@example.com được xem là cùng một khách hàng. Dấu chấm trong địa chỉ được giữ nguyên.
• Chỉ áp dụng cho doanh nghiệp của bạn. Việc chặn chỉ áp dụng cho doanh nghiệp của bạn. Cùng một email vẫn có thể mua hàng từ các doanh nghiệp khác trên Dodo Payments.
• Email phải thuộc về một khách hàng hiện có. Bạn không thể chặn một email chưa từng thanh toán với bạn, và không thể chặn bản ghi khách hàng không có email.

​

Chặn một khách hàng

​

Quản lý khách hàng bị chặn

• Total Customers Blocked: Số lượng khách hàng hiện đang bị chặn.
• Blocked entries: Mỗi lượt chặn chiếm một hàng, với Identifier bạn đã nhập (email hoặc customer ID), Blocked By (thành viên nhóm đã thêm lượt chặn) và Blocked On.
• Search Identifier và Filters: Tìm một mục nhập theo email hoặc customer ID, hoặc lọc theo người đã chặn và thời điểm chặn.
• Action: Quản lý mục nhập, bao gồm bỏ chặn khách hàng.

​

Trang của khách hàng bị chặn

• Huy hiệu Blocked bên cạnh tên khách hàng và nút Unblock Customer.
• Activity Log: Thời điểm khách hàng được thêm vào danh sách chặn, lý do và mọi ghi chú mà nhóm của bạn đã thêm sau đó. Nhấp vào Add Note để ghi lại thông tin mới, chẳng hạn như kết quả của một chargeback. Ghi chú có thể được chỉnh sửa sau.
• Reference IDs: Customer ID liên kết với lượt chặn này, sẵn sàng để sao chép.

​

Bỏ chặn một khách hàng

• Các thay đổi trong Checkout và Customer Portal được khôi phục ngay lập tức.
• Các gói đăng ký đã hủy sẽ không được kích hoạt lại. Khách hàng phải mua lại.
• Mục nhập được giữ lại như một bản ghi kiểm tra cùng với các ghi chú, nhưng không còn xuất hiện trong danh sách đang hoạt động.
• Bạn có thể chặn lại cùng một khách hàng sau này. Thao tác đó sẽ tạo một mục nhập mới.

​

Những gì khách hàng nhìn thấy

• Tại checkout, thanh toán thất bại với thông báo từ chối chung: “This payment cannot be processed.” API trả về HTTP 403 với mã lỗi PAYMENT_NOT_PERMITTED, không nêu nguyên nhân. Lý do thực sự chỉ được ghi vào log của Dodo Payments.
• Trong Customer Portal, mọi thứ đều hiển thị nhưng mọi hành động đều bị vô hiệu hóa. Một thao tác ghi bị chặn trả về PORTAL_ACTION_NOT_PERMITTED với thông báo “This action is not available.” Hồ sơ portal chứa read_only: true để một custom portal integration có thể vô hiệu hóa các nút điều khiển của chính nó. Portal không bao giờ hiển thị mục nhập trong danh sách chặn hoặc các ghi chú của mục nhập.

​

Sử dụng API

​

Chặn một khách hàng

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
}

​

Kiểm tra khách hàng có bị chặn hay không

​

Bỏ chặn một khách hàng

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"

​

Thực tiễn tốt nhất

• Ghi lại lý do. Một lý do ngắn trên lượt chặn, cùng với các ghi chú cho những việc xảy ra sau đó, giúp nhóm hỗ trợ của bạn nắm được toàn bộ diễn biến mà không cần rời dashboard.
• Chặn sau chargeback. Mở khách hàng từ tranh chấp hoặc khoản thanh toán rồi chặn ngay tại đó, hoặc tự động hóa từ webhook dispute.opened với POST /blocklist/customers. Xem Disputes.
• Kiểm tra subscriptions_swept. Khi chặn thông qua API, lặp lại lệnh gọi cho đến khi phản hồi báo true, để không còn gói đăng ký đang hoạt động nào bị bỏ sót.
• Hoàn tiền riêng biệt. Việc chặn chỉ ngăn các giao dịch mua trong tương lai. Nếu bạn nợ khách hàng tiền, hãy hoàn tiền như thường lệ.
• Xem lại danh sách. Bỏ chặn những khách hàng đã giải quyết xong vấn đề. Việc bỏ chặn có hiệu lực ngay lập tức và vẫn giữ lại lịch sử.

​

Liên quan