Method: refundResultNotification

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

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

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

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

חובה: התוצאה של השיחה הזו.

קוד החזר כספי

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

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

קוד החזר כספי של התוצאה שהתקבלה

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

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