التوثيق / المنصة
الملاحظات والتعلّم
أخبر Gurdx بما حدث فعلاً للطلبات والمستخدمين الذين قيّمهم، فتتعلّم نماذج الاحتيال في حسابك منها كل ليلة.
لماذا ترسل الملاحظات#
يقيّم Gurdx المدفوعات افتراضياً بقواعد ونموذج إحصائي مضبوطين للسلع الرقمية التي تُدفع ببطاقة دون حضورها. نتائجك أنت تجعله خاصاً بك:
- نموذج الدفع الخاص بك. يُعاد ضبط النموذج الذي تقوم عليه القاعدة
PF1015كل ليلة على معاملاتك المصنّفة. - أوزان قواعدك. يُعاير وزن كل قاعدة دفع بحسب عدد مرات انطلاقها على طلبات ثبت أنها احتيال.
- ذاكرة السمعة. الهويات التي تؤكد أنها احتيال (معرّف العميل، البريد، الجوال، الجهاز، البطاقة، عنوان IP) ترفع درجة المدفوعات اللاحقة التي تعيد استخدامها (القاعدتان
GX2001وGX2002) ودرجة فحوص IP والبريد والجوال. ويُعامل العملاء ذوو السجل السليم المؤكد الطويل بلطف أكبر. - حدّ مقترح. تعرض صفحة التعلّم في لوحتك حدّ الدرجة الذي كان سيكلّفك أقل على بياناتك.
لا يُطبَّق شيء متعلَّم إلا إذا تفوّق على ما يعمل اليوم في أحدث معاملاتك، ولا يغيّر Gurdx حدودك أو قوائمك السوداء بنفسه (الحظر التلقائي للاحتيال المؤكد إعداد اختياري).
ماذا ترسل#
| متى | الاستدعاء | المحتوى |
|---|---|---|
| سُلِّم الطلب ودُفع | feedback/payment |
outcome: "approved" |
| رفضته بوابة الدفع | feedback/payment |
outcome: "declined" وreason: رمز الرفض |
| استرددت المبلغ | feedback/payment |
outcome: "refunded" |
| وصل اعتراض على العملية | feedback/payment |
outcome: "chargeback" وreason: سبب الاعتراض |
| أكّد فريقك الاحتيال أو أجاز طلباً معلّقاً | feedback/payment |
fraud_confirmed أو legit_confirmed |
| عرفت أن بريداً أو جوالاً أو IP أو جهازاً احتيالي (أو سليم) | feedback/event |
type وvalue وlabel: "fraud" أو "legit" |
| كان تنبيه في لوحتك أو في Webhook صائباً أو خاطئاً | feedback/event |
event_id وlabel |
| كل ليلة، أو مرة واحدة لتاريخك | feedback/bulk |
حتى 1,000 عنصر مما سبق في الاستدعاء |
استخدم نفس transaction_id الذي ترسله إلى كشف احتيال الدفع. يمكن أن تصل النتائج بأي ترتيب: لا يُستبدل chargeback أو fraud_confirmed بـapproved لاحق، والنتيجة لمعاملة لم يقيّمها Gurdx بعد تُحفظ وتُطبَّق عند وصولها.
التكامل المقترح لمتجر سلع رقمية#
- قيّم كل طلب عبر
scoring/paymentقبل التسليم، معtransaction_idوcustomer_idثابتين. - عند تسليم الطلب أرسل
approved. وعند استرداده أو الاعتراض عليه أرسل تلك النتيجة فور علمك بها مع السبب. - عندما يؤكد الدعم الاستيلاء على حساب أو بطاقة مسروقة، أرسل
fraud_confirmedللطلب وصنّف البريد أو الجوال أو الجهاز عبرfeedback/event. - مرة كل ليلة، أعد إرسال نتائج اليوم عبر
feedback/bulk. الاستدعاء لا يكرّر شيئاً، فيُستدرك أي استدعاء فوري فائت. - مرة واحدة، أرسل تاريخك عبر
feedback/bulk: الطلبات السابقة بنتائجها، ومع الطلبات المقيّمة في مكان آخر أرسلcustomer_idوcustomer_emailوcustomer_phoneوcustomer_ip.
curl -X POST "https://gurdx.cretip.com/api/feedback/payment" \
-H "Authorization: Bearer $GURDX_KEY" \
-H "Content-Type: application/json" \
-d '{"transaction_id": "ORD-10492", "outcome": "chargeback", "reason": "fraudulent"}'
كيف يعمل التعلّم#
- التصنيفات. الاعتراض على العملية، ونتيجة
fraud_confirmed، ونتيجةdeclinedيذكر سببها الاحتيال: كلها احتيال. وlegit_confirmedأو القبول الذي مرّ عليه 30 يوماً دون اعتراض: سليم. لا تُستخدم الاستردادات وحالات الرفض الأخرى في التدريب. - متى يبدأ. يُعاد ضبط النموذج متى بلغ حسابك 200 معاملة مصنّفة على الأقل منها 20 حالة احتيال.
- مقارنة عادلة. يُحجز أحدث 20% من معاملاتك المصنّفة للاختبار. لا يُعتمد نموذج أو أوزان جديدة إلا إذا رتّبت الاحتيال أفضل على بيانات الاختبار (AUC أعلى بـ0.01 على الأقل، وبفارق لا تفسّره الصدفة في تلك العيّنة) والتقطت من الاحتيال ما لا يقل عن الحالي عند حدّ الأحداث.
- السمعة تتلاشى. يتناقص الدليل على أي هوية إلى النصف كل 90 يوماً، فتكفّ الأخطاء القديمة عن التأثير.
- الخصوصية. تُحفظ الهويات بصيغة بصمة مشفّرة بمفتاح مع قيمة عرض مقنّعة فقط، ويحذفها طلب حذف بيانات مستخدم أيضاً.
ملاحظات#
- طرق الملاحظات مجانية: لا تُحتسب من حصتك، ومتاحة في كل الباقات.
- وضع الاختبار يتحقق من المحتوى ويرد بنتيجة سليمة الشكل دون حفظ شيء.
- الملاحظة غير الصالحة تُرجع الخطأ 131 (
invalid_feedback)، وأكثر من 1,000 عنصر يُرجع 132 (too_many_feedback_items)، دائماً مع HTTP 200. وفي الاستدعاء بالجملة يُبلَّغ عن العنصر الخاطئ في نتيجته ولا يوقف البقية.
وجدت خطأ؟ أخبرنا عبر صفحة التواصل. تواصل معنا