顧客ブロックリスト

​

顧客をブロックするとどうなるか

​

ブロックによる顧客の照合方法

• そのメールアドレスを持つすべてのレコードが対象です。 Checkout では、以前利用したメールアドレスに対して新しい顧客レコードを作成できるため、単一の customer ID に対するブロックは回避される可能性があります。メールアドレスに対するブロックは回避できません。
• エイリアスも対象です。 メールアドレスは小文字に変換され、+alias を削除したうえで比較されます。そのため、buyer+promo@example.com と Buyer@example.com は同じ顧客として扱われます。アドレス内のドットはそのまま保持されます。
• ビジネス単位で適用されます。 ブロックはあなたのビジネスにのみ適用されます。同じメールアドレスを持つ顧客は、Dodo Payments 上の他のビジネスからは引き続き購入できます。
• メールアドレスは既存の顧客に属している必要があります。 いずれの顧客にも一致しないメールアドレスはブロックできません。また、メールアドレスを持たない顧客レコードもブロックできません。

​

顧客をブロックする

​

ブロックされた顧客を管理する

• Total Customers Blocked: 現在ブロックされている顧客の数です。
• Blocked entries: ブロックごとに1行が表示され、入力した 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 role のチームメンバーはブロックを解除できません。

​

ブロックされた顧客のページ

• 顧客名の横に表示される Blocked バッジと Unblock Customer ボタン。
• Activity Log: 顧客が blocklist に追加された日時、理由、その後チームが追加した note。Add Note をクリックすると、chargeback の結果など、新しい情報を記録できます。note は後から API 経由で編集できます。
• Reference IDs: このブロックに関連付けられた customer ID。コピーして使用できます。

​

顧客のブロックを解除する

• Checkout と Customer Portal の変更は直ちに再び利用できるようになります。
• キャンセルされたサブスクリプションは再有効化されません。 顧客は再度購入する必要があります。
• エントリは note とともに監査記録として保持されますが、有効な一覧には表示されなくなります。
• 同じ顧客を後から再度ブロックできます。その場合は新しいエントリが作成されます。

​

顧客に表示される内容

• 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 を返します。ポータルの profile には read_only: true が設定されるため、custom portal integration では独自の controls を無効化できます。ポータルが blocklist エントリやその note を公開することはありません。

​

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"

​

ベストプラクティス

• 理由を記録する。 ブロックに短い理由を記載し、その後発生したことを note に追加しておくと、ダッシュボードを離れることなく support team が全体像を把握できます。
• chargeback の後にブロックする。 dispute または payment から顧客のページを開いてブロックするか、dispute.opened webhook と POST /blocklist/customers を使用して自動化します。Disputes を参照してください。
• subscriptions_swept を確認する。 API 経由でブロックする場合は、レスポンスが true を返すまで call を繰り返し、live subscription が残らないようにします。
• 返金は別途行う。 ブロックで停止できるのは今後の購入のみです。顧客に返金する必要がある場合は、通常どおり payment を refund してください。
• 一覧を確認する。 問題が解決した顧客はブロックを解除します。ブロック解除はすぐに反映され、履歴も保持されます。

​

関連情報