Method: disburseFundsResultNotification

יש להודיע ל-Google על תוצאת התשלום לאחר ביצוע הקריאה לשיטה של disburseFunds.

הערך של disburseFundsResult הוא אימג' ב-disburseFundsRequestId, ולכן הערך שלו צריך להיות זהה לערך שהוחזר במהלך ה-disburseFunds ואי אפשר לשנות אותו בקריאה בהמשך לשיטה הזו.

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

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

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


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 1,
      "revision": 0
    },
    "requestId": "KcgwSKrV76eVNDUbsZ4UA3",
    "requestTimestamp": "1481852928293"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "disburseFundsRequestId": "awNaC510cefae3IJdNEvW2",
  "disburseFundsResult": {
    "disburseFundsResultCode": "SUCCESS"
  }
}

דוגמה לתשובה:


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

בקשת HTTP

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

גוף הבקשה

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

ייצוג JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "disburseFundsRequestId": string,
  "disburseFundsResult": {
    object (DisburseFundsResult)
  }
}
שדות
requestHeader

object (RequestHeader)

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

string

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

string

חובה: מזהה ייחודי עבור העסקה. זהו ה-requestId שנוצר על ידי Google במהלך השיחה עם disburseFunds המשויכת לבקשה הזו.

זוהי מחרוזת באורך מקסימלי של 100 תווים, והיא מכילה רק את התווים "a-z", "A-Z", "0-9", ":", "-" ו-"_".
disburseFundsResult

object (DisburseFundsResult)

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

גוף התשובה

אובייקט תגובה ל-method disburseFundsResultNotification.

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

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

object (ResponseHeader)

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

enum (DisburseFundsResultNotificationResultCode)

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

תוצאה של העברת כספים

מידע על התוצאה הסופית של תשלום.

ייצוג JSON 
{
  "disburseFundsResultCode": enum (DisburseFundsResultCode),
  "rawResult": {
    object (RawResult)
  },

  // Union field FailureDetail can be only one of the following:
  "transactionMaxLimit": string,
  "transactionMinLimit": string
  // End of list of possible types for union field FailureDetail.
}
שדות
disburseFundsResultCode

enum (DisburseFundsResultCode)

חובה: קוד התוצאה של התשלום הזה.
rawResult

object (RawResult)

אופציונלי: תוצאה גולמית של התשלום הזה. הנתונים משמשים כדי לעזור בניתוח ובניתוח סיכונים של Google. במצבים של מיפוי קודים שנדחו, לפעמים הנתונים מאבדים. השילוב מאפשר לנו לספק ל-Google קוד גולמי. לדוגמה, שער של כרטיס אשראי (השילוב) עשוי להשתמש בשדה זה כדי להעביר ל-Google את קוד הדחייה המדויק שהתקבל מרשת VISA. במקרה כזה, הערך של scope יהיה "Visa" ו-rawCode יהיה הסכום שהתקבל ברשת ה-VISA.

הערך הזה חובה אם result אינו SUCCESS.

שדה איחוד FailureDetail.

FailureDetail יכול להיות רק אחד מהבאים:
transactionMaxLimit

string (Int64Value format)

אופציונלי: אם הערך של disburseFundsResultCode הוא DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT, זה הערך המקסימלי של העסקה המותרת. הפעולה הזו משמשת לניתוח מובנה של הודעות ושל דחיות משתמשים.

הסכום הזה הוא Micros של currencyCode של השיחה המקורית בשיטה disburseFunds.
transactionMinLimit

string (Int64Value format)

אופציונלי: אם הערך של disburseFundsResultCode הוא DISBURSEMENT_UNDER_TRANSACTION_LIMIT, זה הערך של העסקה המינימלית המותרת. הפעולה הזו משמשת לניתוח מובנה של הודעות ושל דחיות משתמשים.

הסכום הזה הוא Micros של currencyCode של השיחה המקורית בשיטה disburseFunds.

DisburseFundsResultCode

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

טיפוסים בני מנייה (enum)
UNKNOWN_RESULT אני לא רוצה להגדיר את ערך ברירת המחדל הזה!
SUCCESS התשלום הועבר בהצלחה.
DISBURSEMENT_UNDER_TRANSACTION_LIMIT סכום התשלום המבוקש לא עומד בסכום המינימלי לכל עסקה של האינטגרל. אם נעשה שימוש בקוד הזה, יש לאכלס את השדה transactionMinLimit בסכום העסקה המינימלי למטרות העברת הודעות למשתמשים.
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT סכום התשלום המבוקש חורג ממגבלת הסכום המקסימלי לכל שילוב. אם הקוד הזה בשימוש, יש לאכלס את השדה transactionMaxLimit במגבלת העסקאות לצורך העברת הודעות למשתמשים.
ACCOUNT_CLOSED החשבון של המשתמש שמשלב את החשבון נסגר. ערך ההחזרה הזה יגרום לסגירת אמצעי התשלום ב-Google. המשתמש יאלץ להוסיף אמצעי תשלום חדש.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER החשבון של המשתמש אשר המשלב נסגר, וחשד שהוא השתלט על החשבון ערך ההחזרה הזה יגרום לסגירת אמצעי התשלום ב-Google. המשתמש יאלץ להוסיף אמצעי תשלום חדש.
ACCOUNT_CLOSED_FRAUD החשבון של המשתמש שנמצא באינטגרל נסגר בגלל הונאה. ערך ההחזרה הזה יגרום לסגירת אמצעי התשלום ב-Google. המשתמש יאלץ להוסיף אמצעי תשלום חדש.
ACCOUNT_ON_HOLD החשבון של המשתמש מושהה.

תוצאה גולמית

אובייקט תוצאה גולמית.

ייצוג JSON 
{
  "scope": string,
  "rawCode": string
}
שדות
scope

string

אופציונלי: ההיקף של RAWCodes יכול להיות ריק.
rawCode

string

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

קוד תשלומים

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

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