قائمة حظر العملاء

يمنع Customer Blocklist جهة سيئة معروفة من الشراء منك مرة أخرى. لا يمكن لعميل محظور الدفع، وتُلغى اشتراكاته النشطة، ويمكنه عرض حسابه في Customer Portal، لكنه لا يستطيع تغيير اشتراكاته. أدر قائمة الحظر من Settings → Blocklist أو عبر Blocklist API.

صفحة إعدادات قائمة الحظر التي تعرض العدد الإجمالي للعملاء المحظورين، وجدولاً بالإدخالات المحظورة يتضمن أعمدة المعرّف، والمحظور بواسطة، والمحظور في، وزر الإضافة إلى قائمة الحظر — The Blocklist tab under Settings

ماذا يحدث عند حظر عميل

يسري الحظر فور إضافته، في كل من المجالات التالية:

المجال	التأثير
Checkout	تُرفض كل محاولة دفع من البريد الإلكتروني المحظور: payment links وcheckout sessions وعمليات الدفع أو الاشتراكات التي يتم إنشاؤها عبر API.
الاشتراكات النشطة	تُلغى الاشتراكات ذات الحالة `pending` أو `active` أو `on_hold` أو `paused` مع السبب `cancelled_by_merchant`. ويتم تشغيل webhook المعتاد `subscription.cancelled` لكل اشتراك منها.
التجديدات وإعادة المحاولات	تتخطى التجديدات التلقائية وإعادة محاولات الدفع العميل المحظور، لذلك لا يتم تحصيل أي مبلغ إضافي حتى إذا كان الإلغاء لا يزال قيد الانتظار.
إعادة المحاولة اليدوية	تُرفض إعادة المحاولة اليدوية لعملية دفع العميل المحظور.
Customer Portal	لا يزال بإمكان العميل تسجيل الدخول وعرض الفواتير والاشتراكات ومفاتيح التراخيص. لكنه لا يستطيع إلغاء اشتراك أو إيقافه مؤقتًا أو استئنافه، أو تغيير الخطط، أو تحديث طريقة الدفع، أو تعديل عنوان الفاتورة. ولا يزال بإمكانه إزالة طريقة دفع محفوظة.

لا يؤدي الحظر إلى رد مبالغ المدفوعات السابقة، ولا يؤثر في النزاعات المفتوحة. أجرِ أي عملية رد أموال بشكل منفصل من صفحة Refunds.

كيفية مطابقة الحظر للعملاء

يمكنك الحظر باستخدام customer ID أو email. وفي كلتا الحالتين، يعتمد الحظر على البريد الإلكتروني للعميل، وليس على سجل العميل:

يشمل كل سجل يستخدم ذلك البريد الإلكتروني. يمكن لـ Checkout إنشاء سجل عميل جديد لبريد إلكتروني عائد، لذلك يمكن تجاوز الحظر على customer ID واحد. أما الحظر على البريد الإلكتروني فلا يمكن تجاوزه بهذه الطريقة.
تشمل المطابقة العناوين البديلة. تتم مقارنة عناوين البريد الإلكتروني بأحرف صغيرة بعد إزالة +alias، لذلك يُعد buyer+promo@example.com وBuyer@example.com العميل نفسه. وتبقى النقاط في العنوان كما هي.
يقتصر على نشاطك التجاري. ينطبق الحظر على نشاطك التجاري فقط. ولا يزال بإمكان البريد الإلكتروني نفسه الشراء من أنشطة تجارية أخرى على Dodo Payments.
يجب أن يكون البريد الإلكتروني تابعًا لعميل حالي. لا يمكنك حظر بريد إلكتروني لا يطابق أيًا من عملائك، ولا يمكنك حظر سجل عميل لا يحتوي على بريد إلكتروني.

حظر عميل

يمكنك حظر عميل من صفحة Blocklist أو من صفحة العميل نفسه.

From Settings
From the customer's page

Open the Blocklist

انتقل إلى Settings → Blocklist في لوحة التحكم.

Add to Blocklist

انقر على Add to Blocklist، ثم أدخل البريد الإلكتروني للعميل أو customer ID في Customer ID or email. تعرض اللوحة العميل المطابق.

Confirm

انقر على Add to Blocklist في اللوحة. تُلغى اشتراكات العميل النشطة فورًا، ويظهر الإدخال في جدول Blocked entries. إذا كانت بعض الاشتراكات لا تزال قيد الإلغاء، تعرض لوحة التحكم إشعارًا. حدّث الصفحة بعد لحظات للتحقق.

لا تطلب لوحة التحكم تحديد سبب. لتسجيل سبب حظر العميل، أضف ملاحظة في صفحة العميل، أو أرسل reason عند الحظر عبر API.

إدارة العملاء المحظورين

تسرد صفحة Blocklist كل حظر نشط:

Total Customers Blocked: عدد العملاء المحظورين حاليًا.
Blocked entries: صف واحد لكل حظر، يتضمن Identifier الذي أدخلته (البريد الإلكتروني أو customer ID)، وBlocked By، وBlocked On. يعرض Blocked By عضو الفريق الذي أضاف الحظر، أو API للحظر المضاف باستخدام API key.
Search Identifier وFilters: ابحث عن إدخال باستخدام البريد الإلكتروني أو customer ID، أو صفِّ النتائج حسب Blocked By وBlocked Between.
Action: يفتح See Details صفحة العميل المحظور، بينما يزيل Unblock الحظر. لا يستطيع أعضاء الفريق الذين لديهم دور Viewer إلغاء الحظر.

صفحة العميل المحظور

Customer Information page for a blocked customer showing the Blocked badge, an Unblock Customer button, an Activity Log with a note and the Added to blocklist event, and a Reference IDs panel with the customer ID — A blocked customer's details page

افتح عميلًا محظورًا من Sales → Customers أو من صفحة Blocklist لعرض ما يلي:

شارة Blocked بجوار اسم العميل، وزر Unblock Customer.
Activity Log: وقت إضافة العميل إلى قائمة الحظر، والسبب، وأي ملاحظات أضافها فريقك منذ ذلك الحين. انقر على Add Note لتسجيل معلومات جديدة، مثل نتيجة عملية رد المبلغ. يمكنك تعديل الملاحظة لاحقًا عبر API.
Reference IDs: customer ID المرتبط بهذا الحظر، وهو جاهز للنسخ.

إلغاء حظر عميل

لإلغاء حظر عميل، انقر على Unblock Customer في صفحة العميل، أو اختر Unblock في عمود Action في صفحة Blocklist. ثم أكد الإجراء باستخدام Unblock.

تتم استعادة تغييرات Checkout وCustomer Portal فورًا.
لا تتم إعادة تفعيل الاشتراكات الملغاة. يجب على العميل الشراء مرة أخرى.
يُحتفظ بالإدخال كسجل تدقيق مع ملاحظاته، لكنه لا يظهر بعد ذلك في القائمة النشطة.
يمكنك حظر العميل نفسه مرة أخرى لاحقًا. يؤدي ذلك إلى إنشاء إدخال جديد.

ما يراه العميل

لا يتم إبلاغ العميل المحظور مطلقًا بأنه محظور.

في Checkout، تفشل عملية الدفع مع رفض عام: “This payment cannot be processed.” يعرض API الحالة HTTP 403 مع رمز الخطأ PAYMENT_NOT_PERMITTED، من دون ذكر أي سبب. ويُسجل السبب الحقيقي في سجلات Dodo Payments فقط.
في Customer Portal، يظهر كل شيء، لكن يُرفض كل إجراء يغيّر الحساب. يعيد الإجراء المرفوض الحالة HTTP 403 مع PORTAL_ACTION_NOT_PERMITTED والرسالة “This action is not available.” ويحمل ملف تعريف البوابة read_only: true، لذلك يمكن لتكامل مخصص مع البوابة تعطيل عناصر التحكم الخاصة به. ولا تعرض البوابة إدخال قائمة الحظر أو ملاحظاته مطلقًا.

إذا كنت تعرض أخطاء Checkout أو البوابة في منتجك، فحافظ على هذا السلوك. اعرض رسالة عامة للخطأين PAYMENT_NOT_PERMITTED وPORTAL_ACTION_NOT_PERMITTED. يؤدي كشف الحظر إلى إخبار الجهة السيئة بتجربة بريد إلكتروني مختلف.

استخدام API

يتيح لك Blocklist API تنفيذ الحظر من أدواتك الخاصة، مثلًا عند وصول chargeback. ويتطلب ذلك API key السري الخاص بك. ويمكن لأي مفتاح سرد الإدخالات وقراءة الملاحظات. أما المفتاح الذي تم تفعيل write access له، فيمكنه حظر العملاء وإلغاء حظرهم وإدارة الملاحظات. وتطبق لوحة التحكم التقسيم نفسه على أدوار الفريق: يقرأ دور Viewer القائمة، بينما يجري دور Editor التغييرات. يتضمن Blocklist API ستة endpoints:

Method	Endpoint	الغرض
`GET`	`/blocklist/customers`	سرد العملاء المحظورين مع عوامل التصفية وعدد `total`
`POST`	`/blocklist/customers`	حظر عميل باستخدام customer ID أو البريد الإلكتروني
`GET`	`/blocklist/customers/{entry_id}`	الحصول على إدخال مع ملاحظاته
`DELETE`	`/blocklist/customers/{entry_id}`	إلغاء حظر عميل
`POST`	`/blocklist/customers/{entry_id}/notes`	إضافة ملاحظة
`PATCH`	`/blocklist/customers/{entry_id}/notes/{note_id}`	تحديث ملاحظة

تعيد القائمة الحظور النشطة فقط. لتصفية النتائج، مرر identifier (مطابقة جزئية غير حساسة لحالة الأحرف للبريد الإلكتروني أو customer ID)، أو blocked_by_email، أو created_at_gte، أو created_at_lte. وتعيد افتراضيًا 10 إدخالات في كل صفحة: عيّن page_size لإعادة ما يصل إلى 100، واستخدم page_number للتنقل بين الصفحات.

حظر عميل

أرسل customer_id أو email في المستوى الأعلى من body. إذا أرسلت كليهما، يستخدم الحظر customer_id. ويُعد reason اختياريًا، ويظهر في صفحة الإدخال. يعيد الحظر الجديد الحالة HTTP 201.

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"
  }'

يصف الرد الإدخال والاشتراكات التي ألغتها العملية:

Response

{
  "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
}

تحتاج هذه الحقول إلى أكبر قدر من الانتباه:

الحقل	الوصف
`identifier`	customer ID أو البريد الإلكتروني الذي أرسلته.
`source`	مصدر الحظر: `blocklist_page` أو `customer_page` أو `payment_page` أو `dispute_page` أو `api`. يسجل API key دائمًا `api`، بغض النظر عن `source` الذي ترسله.
`blocked_by_email`	مستخدم لوحة التحكم الذي أضاف الحظر. `null` بالنسبة إلى API key.
`cancelled_subscription_ids`	الاشتراكات التي ألغتها هذه العملية. يظهر هذا الحقل في رد الإنشاء فقط.
`remaining_subscription_ids`	الاشتراكات التي لا تزال نشطة لأن الإلغاء فشل أو لأن العملية وصلت إلى حد 25 عملية إلغاء.
`subscriptions_swept`	`false` عند بقاء اشتراكات نشطة، أو عندما يتعذر على Dodo Payments سردها. كرر العملية حتى تصبح `true`. يكون الحظر نفسه ساريًا بالفعل.

يؤدي حظر عميل محظور بالفعل إلى إعادة الحالة HTTP 409 مع CUSTOMER_ALREADY_BLOCKED، ما لم تكن الاشتراكات لا تزال بانتظار الإلغاء. في هذه الحالة، تتابع العملية الإلغاء بدلًا من ذلك وتعيد الحالة HTTP 200.

التحقق مما إذا كان العميل محظورًا

يعيد Get Customer Detail حقلين إضافيين: blocked_at، وهو وقت إضافة الحظر النشط (null عندما لا يكون العميل محظورًا)، وblocklist_entry_id، وهو الإدخال المرتبط به. يترك endpoint List Customers الحقلين فارغين.

إلغاء حظر عميل

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"

يعيد endpoint الحالة HTTP 204 عند النجاح، والحالة HTTP 404 عندما لا يطابق ID أي حظر نشط. يؤدي إلغاء الحظر إلى استعادة عمليات الكتابة في Checkout والبوابة، ولا يعيد تفعيل أي اشتراك.

أفضل الممارسات

سجّل السبب. يمنح السبب المختصر على الحظر، إلى جانب الملاحظات الخاصة بأي أحداث لاحقة، فريق الدعم لديك الصورة الكاملة دون مغادرة لوحة التحكم.
احظر بعد chargeback. افتح صفحة العميل من النزاع أو عملية الدفع واحظره من هناك، أو أتمت ذلك من webhook dispute.opened باستخدام POST /blocklist/customers. راجع Disputes.
تحقق من subscriptions_swept. عند الحظر عبر API، كرر العملية حتى يشير الرد إلى true، حتى لا يبقى أي اشتراك نشط.
أجرِ رد الأموال بشكل منفصل. يوقف الحظر عمليات الشراء المستقبلية فقط. إذا كنت مدينًا للعميل بمبلغ، فردّه كالمعتاد.
راجع القائمة. ألغِ حظر العملاء الذين حُلّت مشكلتهم. ويكون إلغاء الحظر فوريًا مع الاحتفاظ بالسجل.

Customer Management

ابحث عن عميل، وافتح صفحة تفاصيله، وأدر اشتراكاته.

Customer Portal

ما يستطيع العميل المحظور فعله وما لا يستطيع فعله في البوابة.

Disputes

استجب لعمليات chargeback وحدد متى يكون الحظر مبررًا.

Error Codes

ما الذي يعنيه PAYMENT_NOT_PERMITTED وPORTAL_ACTION_NOT_PERMITTED.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

ماذا يحدث عند حظر عميل

كيفية مطابقة الحظر للعملاء

حظر عميل

إدارة العملاء المحظورين

صفحة العميل المحظور

إلغاء حظر عميل

ما يراه العميل

استخدام API

حظر عميل

التحقق مما إذا كان العميل محظورًا

إلغاء حظر عميل

أفضل الممارسات

ذات صلة

Customer Management

Customer Portal

Disputes

Error Codes

​ماذا يحدث عند حظر عميل

​كيفية مطابقة الحظر للعملاء

​حظر عميل

​إدارة العملاء المحظورين

​صفحة العميل المحظور

​إلغاء حظر عميل

​ما يراه العميل

​استخدام API

​حظر عميل

​التحقق مما إذا كان العميل محظورًا

​إلغاء حظر عميل

​أفضل الممارسات

​ذات صلة

Customer Management

Customer Portal

Disputes

Error Codes

ماذا يحدث عند حظر عميل

كيفية مطابقة الحظر للعملاء

حظر عميل

إدارة العملاء المحظورين

صفحة العميل المحظور

إلغاء حظر عميل

ما يراه العميل

استخدام API

حظر عميل

التحقق مما إذا كان العميل محظورًا

إلغاء حظر عميل

أفضل الممارسات

ذات صلة