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

סקירה כללית

ה-API של אמצעי התשלום בכרטיסים (Form of Payment) תומך בתשלומים שמבוצעים באמצעות כרטיסים רגילים. אפשר להשתמש בכרטיסי אשראי ובכרטיסי חיוב מיידי. אפשר לקבל תשלומים דרך הודעה יחידה או כפולה.

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

סמלים וכנסים

מילים המפתח "חובה", "חובה", "נדרש", "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 לגבי האירוע כדי לצמצם את ההונאות הכוללות. הדבר יכול להיות מלווה בערעור או בהחזר כספי בעקבות ביטול עסקה בתהליך הערעור.

Google מטמיעה

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