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

​

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

​

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

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

​

حظر عميل

​

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

• إجمالي العملاء المحظورين: عدد العملاء المحظورين حالياً.
• الإدخالات المحظورة: صف واحد لكل حظر، يتضمن المعرّف الذي أدخلته (البريد الإلكتروني أو معرّف العميل)، والمحظور بواسطة (عضو الفريق الذي أضاف الحظر)، وتاريخ الحظر.
• البحث في المعرّف وعوامل التصفية: اعثر على إدخال باستخدام البريد الإلكتروني أو معرّف العميل، أو صفِّ النتائج حسب الشخص الذي أضاف الحظر ووقت إضافته.
• الإجراء: أدر الإدخال، بما في ذلك إلغاء حظر العميل.

​

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

• شارة محظور بجوار اسم العميل، وزر إلغاء حظر العميل.
• سجل النشاط: وقت إضافة العميل إلى قائمة الحظر، والسبب، وأي ملاحظات أضافها فريقك منذ ذلك الحين. انقر على إضافة ملاحظة لتسجيل سياق جديد، مثل نتيجة عملية رد المدفوعات. ويمكن تعديل الملاحظات لاحقاً.
• المعرّفات المرجعية: معرّف العميل المرتبط بهذا الحظر، جاهز للنسخ.

​

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

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

​

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

• عند إتمام الدفع، تفشل الدفعة مع رفض عام: “لا يمكن معالجة هذه الدفعة.” تُرجع API القيمة HTTP 403 مع رمز الخطأ PAYMENT_NOT_PERMITTED، من دون ذكر السبب. ويُسجَّل السبب الحقيقي في سجلات Dodo Payments فقط.
• في Customer Portal، تظل كل العناصر مرئية، لكن تُعطَّل جميع الإجراءات. وتُرجع أي عملية كتابة محظورة 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"

​

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

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

​

ذات صلة