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

בדף הזה מוסבר איך להוסיף הערות להערכות באמצעות אירועי טרנזקציות כדי לשפר את המודל הספציפי לאתר.

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

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

• המוכר מנפיק החזר כספי.

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

מידע נוסף על שליחת הערות זמין במאמר בנושא הוספת הערות להערכות.

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

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

סוג אירוע	תיאור	דוגמה לסיבה	ערך לדוגמה
MERCHANT_APPROVE | MERCHANT_DENY	כשאתם מחליטים אם לאשר את העסקה.	IN_HOUSE	לא רלוונטי
AUTHORIZATION | AUTHORIZATION_DECLINE	כששולחים את העסקה לעיבוד, מנפיק הכרטיס מחליט אם לאשר את העסקה.	‫82 (קוד סיבה שמשמעותו שקוד ה-CVV היה שגוי)	לא רלוונטי
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 שמציין שהתוקף של הכרטיס פג או את קוד השגיאה 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
  }
}

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

• מידע נוסף על תכונות להגנה על חשבונות משתמשים זמין במאמר תכונות להגנה על חשבונות משתמשים.