סקירה כללית
אמצעי תשלום שעבר הצפנה באמצעות אסימון (טוקניזציה) יכול לתמוך בתרחיש לדוגמה של מספר סימוכין. משתמש שרוצה לשלם על מוצרים יוצר מספר אסמכתה דרך כלי שילוב התשלומים. אחר כך המשתמש לוקח את מספר האסמכתה לחנות נוחות, בחנות או בבנק ומשלם את מספר האסמכתה.
אמצעי תשלום במזומן תומך גם בתרחיש לדוגמה של מספר אסמכתה. ההבדל העיקרי בין אמצעי תשלום שעברו הצפנה באמצעות אסימון (טוקניזציה) הוא שאמצעי התשלום שעברו הצפנה באמצעות אסימון (טוקניזציה) מחייב איגוד ותומך בהחזרים כספיים. אמצעי התשלום הזה הוא אמצעי תשלום במזומן, ואילו אמצעי תשלום במזומן לא דורש שיוך ולא תומך בהחזרים כספיים. במסמך הזה מתואר איך יתבצע השילוב בתרחיש לדוגמה של מספר אסמכתה.
באופן כללי, השילוב כולל את התהליכים הבאים:
תהליך הרכישה יהיה זהה לתהליך הרכישה באמצעי תשלום במזומן.
דוגמה לשילוב באמצעות אימות הפניה אוטומטית לאתר.
ממשקי API קשורים
תהליך האימות
API מיושם על ידי מבצע השילוב: אימות אינטרנט.
תהליך השיוך
API מיושם על ידי מבצע השילוב: associateAccount ב-Payment Integrator Hosted Tokenized FOP API.
תהליך רכישה
API מיושם על ידי מבצע השילוב: generateReferenceNumber ו-cancelReferenceNumber ב-API של FOP עם שילוב אסימון מתארח של Payment Integrator.
API שהוטמע על ידי Google: referenceNumberPaidNotification בממשק API מסוג FOP API שמתארח ב-Google Hosted Tokenized.
תהליך ההחזר הכספי
API שהוטמע על ידי מבצע השילוב: refund ב-Payment Integrator Hosted Tokenized FOP API.
תהליך העברת הכספים
API שמיושם על ידי מבצע השילוב: אפשר לעיין בקטע Payment Integrator Hosted Remittance API.
API ש-Google מטמיעה: אפשר לקרוא מידע נוסף במאמר Google Hosted Remittance API.
איך כל התהליכים משתלבים זה בזה
יצירת כלי
בממשק המשתמש של Google, משתמש מופנה לדף אינטרנט מתארח אצל מבצע השילוב כדי לבצע אימות אינטרנט. אחרי שהאימות יסתיים בהצלחה, המשתמש יופנה חזרה אל Google. לאחר מכן Google תקרא ל-associateAccount. הערך requestId ב-authenticationResponse יהיה הauthenticationRequestId של בקשת associateAccount. לאחר שהשיוך מתבצע בהצלחה, Google שומרת את googlePaymentToken(GPT) ומטא-נתונים נוספים ככלי עבור המשתמש.
יצירת כלי – תהליך האימות
יצירת כלי – תהליך השיוך
יצירת מספר סימוכין
כשהמשתמש רוצה לקנות מוצרים/שירותים באמצעות הכלי, Google שולחת קריאה ל-generateReferenceNumber באמצעות GPT. הערך requestId בתוך הכותרת של הבקשה generateReferenceNumber ישמש לזיהוי העסקה עבור ממשקי API קשורים.
שליחת מספר אסמכתה
אחרי שהמשתמש ישלם את מספר האסמכתה אופליין, מבצע השילוב יקרא ל-referenceNumberPaidNotification. הערך requestId בכותרת של הבקשה generateReferenceNumber יהיה generateReferenceNumberRequestId של הבקשה referenceNumberPaidNotification.
ביטול עסקה
אם המשתמש מחליט לבטל את העסקה לפני התשלום, Google תתקשר למספר cancelReferenceNumber. הערך requestId בכותרת של הבקשה generateReferenceNumber יהיה generateReferenceNumberRequestId של הבקשה cancelReferenceNumber.
החזר כספי על עסקה
אם המשתמש רוצה לקבל את הכסף בחזרה, לאחר התשלום של מספר האסמכתה, Google תתקשר ל-refund. הערך requestId בכותרת של הבקשה generateReferenceNumber יהיה transactionId של בקשת refund.
העברת כספים
בהתאם לחוזה, Google תקרא ל-remittanceStatementNotification כדי לעדכן את השילוב כשההצהרה מוכנה. לאחר מכן, השילוב יקרא ל-Google Hosted Remittance API כדי לבצע התאמה.