顧客ブロックリスト

​

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

​

顧客とのブロック照合方法

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

​

顧客をブロックする

​

ブロックされた顧客の管理

• Total Customers Blocked：現在ブロックされている顧客数です。
• Blocked entries：ブロック1件につき1行表示されます。入力したIdentifier（メールアドレスまたはcustomer ID）、Blocked By（ブロックを追加したチームメンバー）、Blocked Onが含まれます。
• Search IdentifierとFilters：メールアドレスまたはcustomer IDでエントリを検索したり、ブロックしたユーザーや日時で絞り込んだりできます。
• Action：顧客のブロック解除など、エントリを管理します。

​

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

• 顧客名の横に表示されるBlockedバッジと、Unblock Customerボタン。
• Activity Log：顧客がブロックリストに追加された日時、理由、それ以降にチームが追加したメモ。Add Noteをクリックすると、チャージバックの結果など、新しい情報を記録できます。メモは後から編集できます。
• Reference IDs：このブロックに紐づくcustomer IDをコピーできます。

​

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

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

​

顧客に表示される内容

• Checkoutでは、支払いが一般的な拒否メッセージ「This payment cannot be processed.」で失敗します。APIはエラーコードPAYMENT_NOT_PERMITTEDとともにHTTP 403を返しますが、原因は示されません。実際の理由はDodo Paymentsのログにのみ記録されます。
• Customer Portalでは、すべての内容を表示できますが、すべての操作が無効になります。ブロックされた書き込み操作は、メッセージ「This action is not available.」とともにPORTAL_ACTION_NOT_PERMITTEDを返します。ポータルのプロフィールにはread_only: trueが付与されるため、カスタムポータル統合で独自のコントロールを無効にできます。ポータルからブロックリストのエントリやメモが表示されることはありません。

​

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"

​

ベストプラクティス

• 理由を記録する。 ブロック時に短い理由を記録し、その後に発生した事象をメモに残しておくと、ダッシュボードを離れることなくサポートチームが経緯を把握できます。
• チャージバック後にブロックする。 disputeまたは支払いから顧客を開いてそこでブロックするか、dispute.opened webhookとPOST /blocklist/customersを使って自動化します。Disputesを参照してください。
• subscriptions_sweptを確認する。 APIでブロックする場合は、レスポンスがtrueを返すまで呼び出しを繰り返し、有効なサブスクリプションが残らないようにします。
• 返金は別途行う。 ブロックで停止されるのは今後の購入のみです。顧客に返金する必要がある場合は、通常どおり支払いを返金してください。
• リストを確認する。 問題が解決した顧客のブロックを解除します。ブロック解除は即時に反映され、履歴も保持されます。

​

関連情報