Google Standard Payments: אמצעי תשלום של כרטיס

סקירה כללית

ה-API של אמצעי התשלום לתשלום בכרטיס תומך בתשלומים שמבוצעים באמצעות כרטיסים רגילים. אמצעי התשלום האלה יכולים להיות כרטיסי אשראי וכרטיסי חיוב מיידי. יש גם מודל אחד דו-שלבי להעברת הודעות.

מושגים חשובים

סמלים וכנסים

מילים המפתח "חובה", "חובה", "נדרש", "SHALL", "SHALL לא", "צריכה", "צריכה לא", "מומלץ", "MAY" ו "אופציונלי" במסמכים אלה צריכות להיות מפורשות כפי שמתואר ב-RFC 2119.

חותמות זמן

כל חותמות הזמן מיוצגות כאלפיות שנייה מאז תחילת מערכת Unix לפי שעון UTC.

לדוגמה:

  • 14 באוגוסט 2010 16:30:00.00 (שעון גריניץ' GMT = 1281803400000)
  • 6 בנובמבר 2007, 21:37:00 MST = 1194410220000

סכומים

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

לדוגמה:

  • 1.23 דולר ארה"ב = 1230000 מיקרו דולר ארה"ב
  • 0.01 דולר ארה"ב = 10,000 מיקרו דולר ארה"ב

אי-ספיקות

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

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

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

תהליך הקלטה של הזמנה

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

הכלי לשילוב תשלומים מטמיע

Google מטמיעה

למידע נוסף על תפיסת שיריוּן שטחי פרסום, ראו כאן מדריך מפורט

תהליך העברת כספים

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

הכלי לשילוב תשלומים מטמיע

Google מטמיעה

לקבלת מידע נוסף על העברת כספים, ראה כאן מדריך מפורט

תהליך ההחזר הכספי

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

הכלי לשילוב תשלומים מטמיע

Google מטמיעה

מידע נוסף על החזרים כספיים זמין במדריך המפורט הזה.

תהליך ההתנגדות

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

Google מטמיעה

מידע נוסף על התנגדויות זמין במדריך המפורט הזה.

תהליך לדיווח על הונאות

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

Google מטמיעה

למידע נוסף על דיווח על הונאות, ראה כאן מדריך מפורט