Method: refundResultNotification

יש לך אפשרות להודיע ל-Google על התוצאה של החזר כספי לאחר ביצוע הפעלת method refund.

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

הערך של refundResult הוא אידמפוטנטי עבור refundRequestId, ולכן לא ניתן לשנות את הערך על ידי קריאה נוספת ל-method הזה.

אם נקודת הקצה נתקלה בשגיאה במהלך עיבוד הבקשה, התשובה מנקודת הקצה הזו תהיה מסוג ErrorResponse.

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

בקשה לדוגמה נראית כך:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 1,
      "revision": 0
    },
    "requestId": "HsKv5pvtQKTtz7rdcw1YqE",
    "requestTimestamp": "1481855928301"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "refundRequestId": "hH1T32PI86CpKwjuf6oD2r",
  "paymentIntegratorRefundId": "invisi/Id::xx__1243",
  "refundResult": "SUCCESS"
}

תגובה לדוגמה נראית כך:


{
  "responseHeader": {
    "responseTimestamp": "1481855928376"
  },
  "result": "SUCCESS"
}

בקשת HTTP

POST https://vgw.googleapis.com/secure-serving/gsp/v1/refundResultNotification/:PIAID

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "refundRequestId": string,
  "refundResult": enum (RefundResultCode),
  "paymentIntegratorRefundId": string
}
שדות
requestHeader

object (RequestHeader)

חובה: כותרת משותפת לכל הבקשות.
paymentIntegratorAccountId

string

חובה: מזהה החשבון של הכלי לשילוב תשלומים שבו בוצע ההחזר הכספי.
refundRequestId

string

חובה: מזהה ייחודי להחזר הכספי הזה, שהוגדר בשדה requestId כשנשלחה קריאה לשיטה refund.
refundResult

enum (RefundResultCode)

חובה: התוצאה של ההחזר הכספי.
paymentIntegratorRefundId

string

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

לנוחיותכם, המזהה הזה נכלל בפרטי ההעברה

גוף התשובה

אובייקט תשובה ל-method refundResultNotification.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": enum (RefundResultNotificationResultCode)
}
שדות
responseHeader

object (ResponseHeader)

חובה: כותרת משותפת לכל התשובות.
result

enum (RefundResultNotificationResultCode)

חובה: תוצאת הקריאה הזו.

RefundResultCode

ההחזרים הכספיים על קודי התוצאות הייחודיים.

טיפוסים בני מנייה (enum)
UNKNOWN_RESULT אל תגדירו את ערך ברירת המחדל הזה אף פעם!
SUCCESS ההחזר הכספי בוצע.
NO_MONEY_LEFT_ON_TRANSACTION ההחזר הכספי נכשל, לא נשאר כסף בעסקה. בדרך כלל מדובר בבאג בין מבצע השילוב לבין Google. Google לא אמורה לבקש החזר כספי בסכום שגבוה מסכום הצילום המקורי.
ACCOUNT_CLOSED

החשבון שהיה פעיל אצל מבצע השילוב נסגר.

החזרת הערך הזה תגרום לסגירת אמצעי התשלום של המשתמש ב-Google. המשתמש ייאלץ להוסיף אמצעי תשלום חדש על ידי ביצוע חוזר של תהליך השיוך.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER

חשבון המשתמש אצל מבצע השילוב נסגר, חשד להשתלטות על חשבון.

החזרת הערך הזה תגרום לסגירת אמצעי התשלום של המשתמש ב-Google. המשתמש ייאלץ להוסיף אמצעי תשלום חדש על ידי ביצוע חוזר של תהליך השיוך.
ACCOUNT_CLOSED_FRAUD

חשבון המשתמש, שהיה שמור אצל מבצע השילוב, נסגר עקב הונאה.

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

RefundResultNotificationResultCode

קודי התוצאות של השיטה refundResultNotification.

טיפוסים בני מנייה (enum)
UNKNOWN_RESULT אל תגדירו את ערך ברירת המחדל הזה אף פעם!
SUCCESS ההודעה על ההחזר הכספי נשלחה בהצלחה.