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 lệnh chặn khớp với khách hàng

• Mọi record có email đó đều được áp dụng. Checkout có thể tạo customer record mới cho email quay lại, vì vậy lệnh chặn theo một customer ID duy nhất có thể bị обход qua. Lệnh chặn theo email thì không.
• Các alias cũng được áp dụng. Email được so sánh ở dạng chữ thường sau khi loại bỏ +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.
• Giới hạn trong doanh nghiệp của bạn. Lệnh 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 email không khớp với khách hàng nào của mình và không thể chặn customer record 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ố khách hàng hiện đang bị chặn.
• Blocked entries: Mỗi lệnh chặn có một dòng, cùng với Identifier bạn đã nhập (email hoặc customer ID), Blocked By và Blocked On. Blocked By hiển thị thành viên nhóm đã thêm lệnh chặn hoặc API đối với lệnh chặn được thêm bằng API key.
• Search Identifier và Filters: Tìm mục nhập theo email hoặc customer ID, hoặc lọc theo Blocked By và Blocked Between.
• Action: See Details mở trang của khách hàng bị chặn, còn Unblock xóa lệnh chặn. Thành viên nhóm có vai trò Viewer không thể bỏ chặn.

​

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 blocklist, lý do và mọi ghi chú 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. Bạn có thể chỉnh sửa ghi chú sau thông qua API.
• Reference IDs: Customer ID liên kết với lệnh chặn này, sẵn sàng để sao chép.

​

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

• Các thay đổi đối với Checkout và Customer Portal được khôi phục ngay lập tức.
• Các gói đăng ký đã hủy 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 dưới dạng audit record 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, khoản 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 cùng mã lỗi PAYMENT_NOT_PERMITTED, không nêu nguyên nhân nào. Lý do thực tế chỉ được ghi vào log của Dodo Payments.
• Trong Customer Portal, mọi thứ đều hiển thị nhưng mọi thao tác thay đổi tài khoản đều bị từ chối. Thao tác bị từ chối trả về HTTP 403 cùng PORTAL_ACTION_NOT_PERMITTED và thông báo “This action is not available.” Hồ sơ portal có read_only: true, vì vậy một custom portal integration có thể vô hiệu hóa các control của chính nó. Portal không bao giờ hiển thị mục nhập blocklist 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"

​

Các phương pháp hay nhất

• Ghi lại lý do. Một lý do ngắn trên lệnh 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 đầy đủ thông tin mà không cần rời dashboard.
• Chặn sau chargeback. Mở trang của khách hàng từ dispute hoặc khoản thanh toán rồi chặn tại đó, hoặc tự động hóa từ webhook dispute.opened bằng 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 response báo true để không còn gói đăng ký đang hoạt động nào bị bỏ lại.
• Hoàn tiền riêng. Lệnh chặn chỉ ngăn các giao dịch mua trong tương lai. Nếu bạn cần trả tiền cho khách hàng, 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