قيّم الشبكة والجهاز في كل سلة تسوق عالية المخاطر مقابل $0.03. ارفع مستوى التحقق البيومتري فقط في الحالات القليلة التي لا تكفي فيها الإشارات وحدها. 500 عملية تحقق مجانية كل شهر.
موثوق به من قبل أكثر من 2,000 مؤسسة حول العالم.
لماذا لا تحتاج معظم عمليات الدفع إلى تعقيدات
90% من الطلبات هي لمشترين يوميين يستخدمون أجهزة موثوقة, يجب أن تمر بسلاسة. الـ 10% التي تشهد ارتفاعًا في المخاطر تخضع للفحص: 0.03 دولار لـ IP + الجهاز في الحالات منخفضة التكلفة، و0.10 دولار للتحقق البيومتري في الحالات عالية القيمة. 500 عملية تحقق مجانية كل شهر.
اختر الفحوصات التي تريدها, الهوية، التحقق من الحياة، مطابقة الوجه، العقوبات، العنوان، العمر، الهاتف، البريد الإلكتروني، الأسئلة المخصصة. اسحبها إلى سير عمل في لوحة التحكم، أو انشر نفس سير العمل إلى واجهة برمجة التطبيقات (API) الخاصة بنا. قم بالتفرع بناءً على الشروط، وقم بإجراء اختبارات A/B، لا يتطلب الأمر أي كود.
$ curl -X POST https://verification.didit.me/v3/session/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workflow_id": "wf_buyer_screen",
"vendor_data": "order-A4421",
"metadata": { "cart_total_cents": 78500 }
}'{ "session_url": "verify.didit.me/..." }// X-Signature-V2 verified upstream
if (payload.status === "Approved") {
shipOrder(payload.vendor_data);
} وإلا إذا (payload.status === "Declined") {
cancelAndRefund(payload.vendor_data);
}{ الحالة: موافق عليه · مرفوض · قيد المراجعة · لم يكتمل }You are integrating a Didit buyer-side fraud screen on a marketplace / e-commerce checkout. Goal: catch stolen-card use, account takeover, gift-card stack abuse, geo-mismatch friendly fraud, and bot scalping on high-value carts. Two stages — cheap signals first, biometric step-up only when signals aren't enough.
WHY THIS SHAPE
- Most checkouts don't need any friction. Day-to-day buyers on trusted devices from residential networks should sail through.
- A small percentage are high-value or high-risk — cart over a threshold, gift-card stack, payout to a new card, geo mismatch, new device, velocity anomaly. On those, run a screen.
- Two stages keep the cost and the friction proportional to the risk. Cheap IP + device check ($0.03) is decisive on the obvious cases. Biometric step-up ($0.10) only fires when the cheap signals are inconclusive AND the order is high-value.
- 500 verifications free every month. The screen runs inside the free tier for most teams while they tune the thresholds.
PRE-REQUISITES
- Production API key from https://business.didit.me (sandbox key in 60 seconds, no credit card).
- A webhook endpoint with HMAC SHA-256 verification of the X-Signature-V2 header using your webhook secret.
- A Workflow Builder workflow with Device & IP Analysis and optionally Passive Liveness + Face Match 1:1 against the stored buyer portrait.
- A server-side cart-gate that defaults to BLOCK on the high-risk path and only unblocks on a verified webhook with status: Approved.
STEP 1 — Decide WHEN to screen (your code, not Didit's)
Run your usual checkout signals. Default triggers worth a screen:
- Cart total above your account-level tier (e.g. > $500)
- Gift-card stack of three or more cards in one order
- Shipping country that doesn't match the billing-card country
- First buy from a new device
- Velocity anomaly — N orders within window W from the same buyer
- Payout / refund destination changed mid-flow
Day-to-day reads from trusted-device + residential-network buyers do NOT need a screen.
STEP 2 — Open the screen session
POST https://verification.didit.me/v3/session/
Headers:
x-api-key: <your api key>
Content-Type: application/json
Body:
{
"workflow_id": "<wf id with Device & IP Analysis + optional Passive Liveness + Face Match 1:1>",
"vendor_data": "<your order id, max 256 chars>",
"callback": "https://<your-app>/checkout/screen/callback",
"metadata": {
"cart_total_cents": 78500,
"currency": "EUR",
"trigger": "high_value_cart"
}
}
Response: 201 Created with a hosted session URL. Show inline at checkout (web), or open in a Software Development Kit (SDK) webview (mobile). The order stays in HOLD on your side until the signed webhook lands.
STEP 3 — Read the signed webhook
Didit POSTs the verdict. Verify X-Signature-V2 (HMAC SHA-256 of the raw body) BEFORE reading the JSON.
Payload (excerpted):
{
"session_id": "<uuid>",
"vendor_data": "<your order id>",
"status": "Approved",
"ip_analysis": { "status": "Approved", "score": 11 },
"liveness": { "status": "Approved" },
"face": { "status": "Approved", "similarity_score": 0.93 }
}
Session status enum (exact case, Title Case With Spaces): Approved | Declined | In Review | Resubmitted | Expired | Not Finished | Kyc Expired | Abandoned.
STEP 4 — Branch the cart action
Approved → ship the order, capture the auth, send the confirmation.
In Review → hold the order. Route to manual review with the per-module signals as the case file.
Declined → cancel the order, refund the auth, log warnings (liveness / face-match / ip flags), throttle the source IP.
Not Finished → invite the buyer to retry the screen with a fresh session URL. Don't ship.
STEP 5 — (Optional) Reusable Know Your Customer (KYC) for returning trusted buyers
Once a buyer has passed identity once on the platform, the credential can replay on future checkouts at no cost via Reusable KYC. Look up the buyer's prior session_id; if the credential is valid and recent, skip the live screen.
That keeps the friction on the unknown traffic only. Free forever.
STEP 6 — Use the decision payload as the chargeback evidence pack
When a dispute lands, pull the full decision payload via:
GET https://verification.didit.me/v3/session/{session_id}/decision/
Headers:
x-api-key: <your api key>
Pairs naturally with:
- 3-D Secure 2.x (3DS2) liability shift on EU cards
- Visa Compelling Evidence 3.0 (CE3.0) — biometric + IP + device fingerprint + prior-order history meets the "trusted customer" bar
- Mastercard Identity Check chargeback dispute kit
WEBHOOK EVENT NAMES
- Sessions: standard session webhook. One endpoint, status field tells you the lifecycle.
- Verify X-Signature-V2 (HMAC SHA-256) on every payload.
WHAT IT BLOCKS
- Stolen-card use on first-time-buy + geo mismatch
- Account takeover on a previously-verified buyer (the step-up is the second-factor)
- Friendly fraud where the cardholder disputes a charge they actually authorised
- Bot scalpers running multi-item carts from datacenter Internet Protocol (IP) addresses
- Gift-card stack drains funded by a stolen card
- Reshipper / mule patterns (ship-to address inconsistent with prior orders)
CONSTRAINTS
- Session statuses use Title Case With Spaces. Never UPPER_SNAKE_CASE — that's the Transactions API.
- Start with IP-only on the cheap cases. Add the biometric step-up only on high-value carts or when IP alone is inconclusive — keeps cost down and friction proportional.
- 200+ fraud signals are evaluated on every session at no extra cost — read them off the decision payload, don't re-query.
Read the docs:
- https://docs.didit.me/sessions-api/create-session
- https://docs.didit.me/core-technology/ip-analysis/overview
- https://docs.didit.me/core-technology/biometric-auth/overview
- https://docs.didit.me/core-technology/reusable-kyc/overview
- https://docs.didit.me/integration/webhooks
Start free at https://business.didit.me — sandbox key in 60 seconds, 500 verifications free every month, no credit card.
للبناء والاختبار، وللمستخدمين الأوائل.
أكثر من 25 وحدة، بأسعار معلنة للجميع. خصومات تلقائية على الكميات.
للحجوم الكبيرة والبرامج المنظمة.
تُطبق خصومات الحجم تلقائيًا مع زيادة الاستخدام — لا تفاوض، ولا مكالمات مبيعات.
Didit هي بنية تحتية للهوية والاحتيال، المنصة التي تمنينا وجودها عندما كنا نبني منتجاتنا بأنفسنا: مفتوحة، مرنة، وصديقة للمطورين، لتعمل كجزء حقيقي من حزمة التقنية الخاصة بك بدلاً من صندوق أسود تدمجه حوله.
تغطي واجهة برمجة تطبيقات واحدة التحقق من الأشخاص (KYC، اعرف عميلك)، والتحقق من الشركات (KYB، اعرف عملك)، وفحص محافظ العملات المشفرة (KYT، اعرف معاملتك)، ومراقبة المعاملات في الوقت الفعلي، على بنية مصممة لتكون:
البصمة الأساسية: أكثر من 14,000 نوع مستند بـ أكثر من 48 لغة، أكثر من 1,000 مصدر بيانات، وأكثر من 200 إشارة احتيال في كل جلسة. تتعلم بنية Didit التحتية ديناميكيًا من كل جلسة وتتحسن يومًا بعد يوم.
أي نمط لا يملك فيه الشخص الذي يدفع الحق في الدفع بهذه الأداة، أو عندما يتم تنظيم المعاملة لتشغيل عملية استرداد لاحقًا.
الأشكال الشائعة:
الاحتكاك له تكلفة. ينخفض التحويل بشكل ملحوظ مع كل خطوة دفع إضافية. يجب أن يمر معظم المشترين, جهاز معروف، شبكة منزلية، إجمالي سلة تسوق عادي, دون أي فحص على الإطلاق.
تحافظ المرحلتان على تناسب الاحتكاك مع المخاطر:
$0.03), تحليل الجهاز وعنوان IP رخيص وصامت. حاسم في الحالات الواضحة (VPN + مركز بيانات بروتوكول الإنترنت (IP) + متصفح بلا واجهة رسومية = حظر فوري؛ جهاز موثوق + مزود خدمة إنترنت منزلي = مرور فوري).$0.10), التحقق الحيوي السلبي لا يتم تفعيله إلا في الشريحة الصغيرة التي تكون فيها المرحلة 1 غير حاسمة وإجمالي سلة التسوق أعلى من الحد الذي يستحق العناء.النتيجة: لا يضيف متوسط عملية الدفع أي احتكاك، وتحصل الشريحة عالية المخاطر على فحص حاسم.
تستغرق العملية الكاملة عادةً أقل من 30 ثانية من البداية إلى النهاية, التقاط الهوية، تصوير المستند، تصوير السيلفي، انتهى. هذا هو الأسرع في السوق. عادةً ما يستغرق مزودو KYC التقليديون أكثر من 90 ثانية لنفس العملية.
في الواجهة الخلفية، تعيد Didit النتيجة في أقل من ثانيتين عند p99، مقاسة من لحظة انتهاء المستخدم من السيلفي إلى لحظة تشغيل الويب هوك الخاص بك. تم ضبط التقاط الهاتف المحمول للهواتف البطيئة والشبكات البطيئة: ضغط تدريجي للصور، تحميل كسول لحزمة تطوير البرامج (SDK)، وتسليم بنقرة واحدة من سطح المكتب إلى الهاتف عبر رمز الاستجابة السريعة إذا بدأ المستخدم على الويب.
فقط عندما تكون المرحلة 1 غير حاسمة ويكون الطلب ذا قيمة عالية بما يكفي لتبرير الاحتكاك. أمثلة:
التحقق هو التحقق الحيوي السلبي بسعر 0.10 دولار، اختياريًا مع مطابقة الوجه 1:1 مقابل صورة المشتري المخزنة بتكلفة إضافية 0.05 دولار. حكم في أقل من ثانيتين على أجهزة Android ذات المستوى المبتدئ.
تصل كل جلسة إلى إحدى الحالات السبع الواضحة، لذلك يعرف الكود الخاص بك دائمًا ما يجب فعله:
Approved, اجتازت جميع الفحوصات. انقل المستخدم إلى الأمام.Declined, فشل فحص واحد أو أكثر. يمكنك السماح للمستخدم بإعادة إرسال الخطوة الفاشلة المحددة (على سبيل المثال، إعادة التقاط السيلفي) دون إعادة تشغيل العملية بأكملها.In Review, تم وضع علامة للمراجعة الامتثالية. افتح الحالة في لوحة التحكم، واطلع على كل إشارة، وقرر الموافقة أو الرفض.In Progress, المستخدم في منتصف العملية.Not Started, تم إرسال الرابط، ولم يفتحه المستخدم بعد. أرسل تذكيرًا إذا بقي طويلاً.Abandoned, فتح المستخدم الرابط ولكنه لم ينهِ في الوقت المحدد. أعد التفاعل أو انتهت صلاحيته.Expired, انتهت صلاحية رابط الجلسة. أنشئ جلسة جديدة.يتم تشغيل ويب هوك موقع عند كل تغيير في الحالة، لذلك تظل قاعدة بياناتك متزامنة دائمًا. الجلسات المهجورة والمرفوضة مجانية.
تتم معالجة بيانات الإنتاج وتخزينها في الاتحاد الأوروبي افتراضيًا، على خدمات Amazon Web Services. يمكن لعقود الشركات طلب مناطق بديلة للولايات القضائية التي تتطلبها جهات التنظيم.
التشفير في كل مكان. AES-256 في وضع السكون عبر كل قاعدة بيانات، ومخزن كائنات، ونسخة احتياطية. Transport Layer Security 1.3 أثناء النقل في كل استدعاء API، و webhook، وجلسة Business Console. يتم تشفير البيانات البيومترية بمفتاح رئيسي منفصل للعميل.
الاحتفاظ تحت سيطرتك. الاحتفاظ الافتراضي هو غير محدود (بلا حدود) ما لم تقم بتكوين مدة أقصر، تتراوح بين 30 يومًا و 10 سنوات لكل تطبيق، ويمكنك حذف أي جلسة فردية في أي وقت من لوحة التحكم أو واجهة برمجة التطبيقات.
الشهادات: SOC 2 Type 1 & Type 2، ISO/IEC 27001:2022، iBeta Level 1 PAD، وشهادة عامة من Tesoro / SEPBLAC / CNMV الإسبانية بأن التحقق من الهوية عن بعد من Didit أكثر أمانًا من التحقق من الهوية شخصيًا. التقرير الكامل متاح على /security-compliance.
تتوافق Didit بشكل افتراضي مع الهيئات التنظيمية المهمة للبنية التحتية للهوية:
مذكرة مفصلة، كل شهادة، كل خطاب من الجهات التنظيمية: /security-compliance.
ثلاثة مسارات تكامل, اختر ما يناسب نظامك:
نفس لوحة التحكم، نفس الفواتير، نفس سعر الدفع مقابل النجاح للثلاثة. دليل خطوة بخطوة على docs.didit.me/integration/integration-prompt.
نعم. نفس POST /v3/session/ يدعم كلاهما. على الويب، اعرض session_url المعادة مباشرة عند الدفع. على الهاتف المحمول، افتحها في عرض الويب الخاص بـ حزمة تطوير البرامج (SDK) من Didit, تتوفر خمس حزم SDK: للويب، iOS، Android، React Native، Flutter، وجميعها مجانية.
تأتي النتيجة عبر نفس الويب هوك الموقع بغض النظر عن الواجهة. تكامل واحد، كل المنصات.
بندان في أسوأ الأحوال:
متوسط عملية الدفع المحمية التي تحتاج إلى كلتا المرحلتين: ~0.13 دولار. معظم عمليات الدفع تشغل المرحلة 1 فقط بتكلفة 0.03 دولار. المشترون الموثوق بهم العائدون عبر KYC القابل لإعادة الاستخدام مجانيون إلى الأبد.
أول 500 عملية تحقق كل شهر مجانية في كل حساب.
في أي مكان تكون فيه السلة كبيرة بما يكفي لكي يؤذي شراء ببطاقة مسروقة:
سير عمل واحد، كل أشكال السلة.
واجهة برمجية واحدة لـ KYC و KYB ومراقبة المعاملات وفحص المحافظ. ادمجها في 5 دقائق.