Method: disburseFundsResultNotification

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

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

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

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

DisburseFundsResult

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

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

הסכום הזה הוא מיקרו של אותו currencyCode כמו הפעלת ה-method המקורית disburseFunds.
transactionMinLimit

string (Int64Value format)

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

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

RawResult

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

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

string

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

string

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

DisburseFundsResultNotificationResultCode

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

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