הוספת הערות להערכות עם אירועי עסקאות

הערות לאירועי טרנזקציות ב-Fraud Defense מאפשרות לכם לספק נתונים על מחזור החיים של התשלום אחרי ההערכה, כמו הסדרים, החזרים כספיים בעקבות ביטול עסקה והחזרים כספיים. המשוב הזה עוזר לכם לשפר את המודל הספציפי לאתר שלכם ואת ההחלטות העתידיות לגבי הונאות.

כדי שההגנה על עסקאות תפעל בצורה הכי טובה, צריך שתהיה לה גישה לאירועים במחזור החיים של התשלומים בעסקאות. לכן, מומלץ לשלוח הערות לגבי הבדיקות שיצרתם עם נתוני עסקאות. לדוגמה, אתם יכולים לספק את פרטי העסקה ל-"הגנה על עסקאות" כאירוע עסקה בתרחישים הבאים:

  • ספק התשלומים מאשר או דוחה את העסקה.

  • המוכר מבצע החזר כספי.

  • מנפיק התשלום מגיש בקשה להחזר כספי.

איך שולחים הערות

מומלץ לשלוח את הבקשות האלה באופן אוטומטי כחלק מהלוגיקה המתאימה במערכת שלכם כשהנתונים זמינים, למשל כשסטטוס העסקה משתנה.

אחרי שיוצרים הערכה עם נתוני העסקאות, התכונה "הגנה על עסקאות" מחזירה החלטה ושם הערכה. מוסיפים הערות להערכה עם אירועי עסקאות בשלבים החשובים הבאים במחזור החיים של התשלום, כשהם מתרחשים:

סוג אירוע תיאור דוגמה לסיבה ערך לדוגמה
MERCHANT_APPROVE | MERCHANT_DENY כשאתם מחליטים אם לאשר את העסקה. IN_HOUSE לא רלוונטי
AUTHORIZATION | AUTHORIZATION_DECLINE כשאתם שולחים את העסקה לעיבוד, ומנפיק הכרטיס מחליט אם לאשר את העסקה. 82 (קוד סיבה שמשמעותו היא שקוד האימות שגוי) לא רלוונטי
CHARGEBACK כשהעסקה מחויבת בהחזר כספי. Card Reported Stolen ‫20 (מייצג החזר כספי חלקי בעקבות ביטול עסקה של 20 יחידות מטבע)

יחד עם סוג האירוע CHARGEBACK, צריך לכלול את קוד הסיבה להחזר הכספי שסופק על ידי מנפיק הכרטיס, באמצעות השדה reason. בנוסף, אם העסקה בוטלה באופן חלקי, צריך לציין בשדה value את הסכום הכספי שבוטל.

בשדה reason של אירוע העסקה, צריך לכלול מונחים שמבהירים את ההקשר של הסיבה לאירוע, או לספק קודי סיבה שמתקבלים ישירות מרשת התשלומים או ממנפיק הכרטיס. המונחים והקודים האלה משתנים בהתאם לסוג האירוע.

בטבלה הבאה מפורטת הרשימה המלאה של סוגי אירועי העסקאות:

סיבת ההערה תיאור
MERCHANT_APPROVE מציין שהעסקה אושרה על ידי המוכר. הסיבות הנלוות יכולות לכלול מונחים כמו IN_HOUSE,‏ ACCERTIFY,‏ CYBERSOURCE או MANUAL_REVIEW.
MERCHANT_DENY מציין שהעסקה נדחתה והסתיימה בגלל סיכונים שזוהו על ידי המוכר. הסיבות הנלוות יכולות לכלול מונחים כמו IN_HOUSE,‏ ACCERTIFY,‏ CYBERSOURCE או MANUAL_REVIEW.
MANUAL_REVIEW מציין שהעסקה נבדקת על ידי אדם, בגלל חשד או סיכון.
AUTHORIZATION מציין שניסיון ההרשאה מול מנפיק הכרטיס הצליח.
AUTHORIZATION_DECLINE מציין שניסיון ההרשאה מול מנפיק הכרטיס נכשל. הסיבות הנלוות יכולות לכלול את 54 של Visa, שמציין שתוקף הכרטיס פג, או את 82, שמציין שה-CVV שגוי.
PAYMENT_CAPTURE מציין שהעסקה הושלמה כי הכסף הועבר.
PAYMENT_CAPTURE_DECLINE מציין שלא ניתן היה להשלים את העסקה כי הכספים לא הוסדרו.
CANCEL מציין שהעסקה בוטלה. מציינים את הסיבה לביטול. לדוגמה, INSUFFICIENT_INVENTORY.
CHARGEBACK_INQUIRY מציין שהמוכר קיבל בירור לגבי החזר כספי בעקבות ביטול עסקה בגלל הונאה, ושהוא צריך לספק מידע נוסף לפני שההחזר הכספי יונפק באופן רשמי ותישלח הודעה רשמית על ההחזר הכספי.
CHARGEBACK_ALERT מציין שהמוכר קיבל התראה על החזר כספי בעקבות ביטול עסקה בגלל הונאה בעסקה. מתחיל תהליך לפתרון המחלוקת בלי לערב את רשת התשלומים.
FRAUD_NOTIFICATION מציין שהונפקה התראה על הונאה בעסקה, שנשלחה על ידי הבנק המנפיק של אמצעי התשלום כי נראה שהעסקה היא הונאה. מומלץ לכלול נתונים של TC40 או SAFE בשדה reason של סוג האירוע הזה. במקרה של החזרים כספיים חלקיים, מומלץ לכלול סכום בשדה value.
CHARGEBACK מציין שרשת התשלומים הודיעה למוכר שהעסקה נכנסה לתהליך של החזר כספי בעקבות ביטול עסקה בגלל הונאה. דוגמאות לקודי סיבה: 6005 ו-6041 של Discover. במקרה של החזרים כספיים חלקיים, מומלץ לכלול סכום בשדה value.
CHARGEBACK_REPRESENTMENT מציין שהעסקה נכנסה לתהליך של החזר כספי בעקבות ביטול עסקה בגלל הונאה, ושהמוכר בחר להגיש בקשה להצגה חוזרת של העסקה. דוגמאות לסיבות: 6005 ו-6041 של Discover. במקרה של החזרים כספיים חלקיים, מומלץ לכלול סכום בשדה value.
CHARGEBACK_REVERSE מציין שהעסקה כללה החזר כספי בעקבות ביטול עסקה בגלל הונאה, שהיה לא חוקי ובוטל כתוצאה מכך. במקרה של החזרים כספיים חלקיים, מומלץ לכלול סכום בשדה value.
REFUND_REQUEST מציין שהמוכר קיבל החזר כספי על עסקה שהושלמה. במקרה של החזרים כספיים חלקיים, מומלץ לכלול סכום בשדה value. דוגמה לסיבה: FRAUD.
REFUND_DECLINE מציין שהמוכר קיבל בקשה להחזר כספי על העסקה הזו, אבל דחה אותה. במקרה של החזרים כספיים חלקיים, מומלץ לכלול סכום בשדה value. דוגמה לסיבה: FRAUD.
REFUND מציין שהמוכר ביצע החזר כספי על העסקה שהושלמה. להחזרים כספיים חלקיים, מומלץ לכלול סכום בשדה value. דוגמה לסיבה: PROACTIVE_FRAUD.
REFUND_REVERSE מציין שהעסקה שהושלמה קיבלה החזר כספי מהמוכר, ושההחזר הכספי הזה בוטל. במקרה של החזרים כספיים חלקיים, מומלץ לכלול סכום בשדה value.

בדוגמה הבאה מוצג מטען ייעודי (payload) לדוגמה של הערה שמכילה אירוע של עסקה. פרטים נוספים זמינים במאמר הוספת הערות למטלות.

POST https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate
{
  "transaction_event": {
    "event_type": "CHARGEBACK",
    "reason": "Card Reported Stolen",
    "value": 20
  }
}

המאמרים הבאים