אימות כתובת לביצוע תשלום במסחר אלקטרוני

מטרה

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

דרישות מוקדמות

Google ממליצה להכיר את הנושאים הבאים:

  • השלמה אוטומטית של מקומות מפתח JavaScript תיעוד.
    • להבין מנקודת מבט טכנית על האופן שבו השלמה אוטומטית של מקום עובד והאפשרויות ליישום שלו.
  • מדריך להטמעת תשלום מקום השלמה אוטומטית.
    • דוגמאות לשיטות מומלצות ליישום השלמה אוטומטית של מקומות תשלום במסחר אלקטרוני.
  • מוצר של Address Validation API תיעוד, עם התמקדות בבניית אימות בלוגיקה.
    • להבין מנקודת מבט טכנית על האופן שבו ה-API של אימות כתובת פועל ולבדוק את האותות שקובעים את איכות הכתובת.

מהו אימות כתובת?

ה-API לאימות כתובת הוא שירות שמקבל כתובות. היא מזהה את רכיבי הכתובת ומאמתת אותם. הוא גם יוצר סטנדרטיזציה כתובת למשלוח דואר ומוצאים את קואורדינטות קווי האורך/רוחב הידועות ביותר עבורו. אופציונלי: עבור כתובות בארצות הברית ובפוארטו ריקו, אפשר להפעיל מערכת התמיכה לדיוק קידוד (CASSTM).

למה צריך לאמת את הכתובת בקופה?

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

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

סקירה כללית על ההטמעה

קטע זה מתאר את תהליך העבודה המומלץ להזנת כתובת עבור מסחר אלקטרוני בתהליך התשלום. התהליך מורכב משלושה שלבים:

  1. להשתמש בהשלמה אוטומטית למקום כדי לתעד את הכתובת.
  2. צריך להשתמש ב-API לאימות כתובת כדי לאשר את הכתובת שהוזנה.
  3. להציג במפה את המיקום של הכתובת שהוזנה כדי לספק משלוח תחושת הביטחון של הלקוחות.

לאחר מכן נתעמק בכל שלב בנפרד.

שלב 1: תהליך הזנת הכתובת - באמצעות שירות ההשלמה האוטומטית של המקום

יישום מקום השלמה אוטומטית באמצעות JavaScript API בשורה הראשונה בטופס הזנת הכתובת.

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

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

הדוגמה הבאה ממחישה איך התהליך הזה עשוי להופיע באמצעות שדה להזנת קלט אחד:

תמונה

שלב 2: משתמשים ב-API לאימות כתובות כדי לאמת כתובות

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

Google ממליצה להפעיל את ה-API לאימות כתובת בכל עסקה.

תרשים הזרימה הבא ממחיש דוגמה לשילוב מקצה לקצה של ממשק API לאימות כתובת בשלב התשלום:

תמונה

במסמך הזה מתוארים תרחישים של קבלת כתובות בהמשך.

שלב 3: מספקים אישור חזותי

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

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

Maps JavaScript API מספק מפה אינטראקטיבית להצגת מיקום המשתמש. ה-API הסטטי של מפות Google מאפשר הטמעת תמונה בדף האינטרנט או בשלב מאוחר יותר באימייל.

ניתוח מעמיק – תרחישים של אישור בקשות

אפשר לסווג את התגובות ב-API לאימות כתובות לשלושה תרחישים עיקריים:

  • תיקון – הכתובת באיכות נמוכה. עליך לבקש מידע נוסף.
  • אישור – הכתובת באיכות גבוהה אבל משתנה מכתובת הקלט. יכול להיות שתתבקשו אישור.
  • אישור – הכתובת באיכות גבוהה. אפשר מאשרים את הכתובת שצוינה.

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

תיקון

תמונה

בקטע הזה נסביר איך לתקן קלט של כתובת. לקבלת מידע על אותות שה-API לאימות כתובת חוזר כדי לציין איכות נמוכה. לפי כתובת, יש לעיין במאמר תיקון address (address) במסמכי התיעוד של 'בניית לוגיקת האימות שלך'.

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

אפשר גם להדגיש שגיאות ספציפיות בשורת הכתובת באמצעות האותות הוחזרו ברמת addressComponents. אפשר לראות דוגמה לכך בקטע צילום מסך מימין.

אישור

תמונה

בקטע הזה מוסבר איך לאמת כתובת. לקבלת מידע על אותות שה-API לאימות כתובת חוזר כדי לציין שהכתובת צריכה להיות מאושר, ראו אישור address (address) במסמכי התיעוד של 'בניית לוגיקת האימות שלך'.

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

להשתמש בחלון מעברון כדי להציג את המידע ללקוח, וכך כדי להמשיך:

  1. מאשרים את הכתובת כפי שהוחזרה על ידי ה-API ואת תהליך התשלום ממשיך להשתמש בכתובת המתוקנת.
  2. בוחרים את הכתובת כפי שהוזנה במקור, תוך התעלמות מהתיקון ממשק ה-API לאימות כתובות. תהליך התשלום יכול להמשיך כרגיל. אפשר לסמן את ההזמנה לבדיקה במורד הזרם לפני המשלוח, אם התהליך מאפשרת.
  3. הלקוח מבטל את המודל או חוזר ממנו ומחזיר אותו הזנת הכתובת בתהליך התשלום, שבו הוא יוכל להזין מחדש את מאפס, להתחיל את התהליך מחדש.

דוגמה לכך מופיעה בצילום המסך שמשמאל.

אישור

בקטע הזה מוסבר איך מקבלים כתובת. לקבלת מידע על אותות שה-API לאימות כתובת חוזר כדי לציין שהכתובת תקינה. על האיכות של התוכן שלך, ועליך לקבל אותו. מידע נוסף זמין בקטע אישור address (address) במסמכי התיעוד של 'בניית לוגיקת האימות שלך'.

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

מומלץ להשתמש בנתוני הכתובת שהוחזרו מה-API לאימות כתובת מול הצו, כי הוא עשוי לכלול תיקונים ותוספות קטנים, כמו:

  • שימוש באותיות רישיות
  • תיקונים בפורמט, לדוגמה
    • מרחוב לרחוב
    • סדר נכון של רכיבי הכתובת
  • ZIP+4 בארה"ב.

למה כדאי להטמיע מעקב אחר אירועים?

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

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

יש שתי הצעות לאישור של הניסיון השני:

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

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

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

לאחר השלמת תהליך התשלום, משתמשים provideValidationFeedback שיטה לשליחת משוב ל-Google על ניסיון אימות כתובת ספציפי.

סיכום

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

השלבים הבאים

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

הצעות לקריאה נוספת:

תורמים

Henrik Valve | מהנדסי פתרונות
תומס אנגלרט | מהנדסי פתרונות
סרתאק גאנגולי | מהנדסי פתרונות

  1. בעל רישיון לא בלעדי של שירות הדואר בארצות הברית. הסימנים המסחריים הבאים נמצאים בבעלות רשות הדואר של ארצות הברית, ומשתמשים בהם עם הרשאה: CASSTM, USPS®, DPV®. ↩