Method: captureResultNotification

דיווח ל-Google על התוצאה של צילום המסך לאחר שבוצעה קריאה לשיטה capture או asynchronousCapture.

הערך של captureResult הוא אימג' ב-captureRequestId ולכן לא ניתן לשנות את הערך שלו באמצעות קריאה נוספת לשיטה הזו.

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

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

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


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 1,
      "revision": 0
    },
    "requestId": "KcgwSKrV76eVNDUbsZ4UA3",
    "requestTimestamp": "1481852928293"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "captureRequestId": "awNaC510cefae3IJdNEvW2",
  "captureResult": {
    "captureResultCode": "SUCCESS"
  }
}

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


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

בקשת HTTP

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

גוף הבקשה

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

ייצוג JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "captureRequestId": string,
  "captureResult": {
    object (CaptureResult)
  },
  "paymentIntegratorTransactionId": string
}
שדות
requestHeader

object (RequestHeader)

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

string

חובה: מזהה החשבון של הכלי לשילוב תשלומים שבו בוצעה הצילום.
captureRequestId

string

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

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

object (CaptureResult)

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

string

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

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

גוף התשובה

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

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

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

object (ResponseHeader)

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

enum (CaptureResultNotificationResultCode)

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

תוצאות של צילום

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

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

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

enum (CaptureResultCode)

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

object (RawResult)

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

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

שדה איחוד FailureDetail.

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

string (Int64Value format)

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

הסכום הזה הוא Micros של currencyCode של השיחה המקורית מסוג capture או asynchronousCapture.
transactionMinLimit

string (Int64Value format)

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

הסכום הזה הוא Micros של currencyCode של השיחה המקורית מסוג capture או asynchronousCapture.
currentBalance

string (Int64Value format)

אופציונלי: אם התוצאה היא INSUFFICIENT_FUNDS, זוהי היתרה הזמינה כרגע בחשבון המשתמש (במיקרו). ההגדרה הזו משמשת לשליחת הודעות מובנות ומוצגות למשתמשים.

הערך הזה צריך להיות זהה למטבע של currencyCode שצוין בבקשה.

קוד של CaptureResult

קודי התוצאות של צילום.

טיפוסים בני מנייה (enum)
UNKNOWN_RESULT אני לא רוצה להגדיר את ערך ברירת המחדל הזה!
SUCCESS הצילום הצליח.
CHARGE_UNDER_TRANSACTION_LIMIT סכום הצילום המבוקש לא עומד בסכום המינימלי לכל עסקה של האינטגרל. אם נעשה שימוש בקוד הזה, יש לאכלס את השדה transactionMinLimit בסכום העסקה המינימלי למטרות העברת הודעות למשתמשים.
CHARGE_EXCEEDS_TRANSACTION_LIMIT סכום הצילום המבוקש חורג מהמגבלה המקסימלית של המספר המשולב. אם הקוד הזה בשימוש, יש לאכלס את השדה transactionMaxLimit במגבלת העסקאות לצורך העברת הודעות למשתמשים.
CHARGE_EXCEEDS_DAILY_LIMIT לא ניתן להשתמש בחשבון של משתמש לביצוע רכישות כרגע, כי הוא חרג מהמגבלה היומית.
CHARGE_EXCEEDS_MONTHLY_LIMIT לא ניתן להשתמש בחשבון של משתמש לביצוע רכישות כרגע, כי הוא חרג מהמגבלה החודשית.
INSUFFICIENT_FUNDS בחשבון הזה אין מספיק כסף כדי להבטיח את הצילום.
SUSPECTED_FRAUD למטמיע יש סיבה לחשוד שהעסקה הזו היא תרמית.
ACCOUNT_CLOSED החשבון של המשתמש שמשלב את החשבון נסגר. ערך ההחזרה הזה יגרום לסגירת אמצעי התשלום ב-Google. המשתמש יאלץ להוסיף אמצעי תשלום חדש.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER החשבון של המשתמש אשר המשלב נסגר, וחשד שהוא השתלט על החשבון ערך ההחזרה הזה יגרום לסגירת אמצעי התשלום ב-Google. המשתמש יאלץ להוסיף אמצעי תשלום חדש.
ACCOUNT_CLOSED_FRAUD החשבון של המשתמש שנמצא באינטגרל נסגר בגלל הונאה. ערך ההחזרה הזה יגרום לסגירת אמצעי התשלום ב-Google. המשתמש יאלץ להוסיף אמצעי תשלום חדש.
ACCOUNT_ON_HOLD החשבון של המשתמש מושהה.
OTP_NOT_MATCHED הסיסמה החד-פעמית לא התאימה למה שהשילוב שלח.
OTP_ALREADY_USED כבר נעשה שימוש ב-OTP.
CAPTURE_REQUEST_EXPIRED נדרש יותר מדי זמן כדי לשלב את הכסף של המשתמש. Google תדחה את הדחייה הזו כסטטוס סופי, ולכן מי שמטמיע את הקובץ חייב לוודא שהכספים לא מתועדים בשלב מאוחר יותר או שהמשתמש יקבל החזר כספי באופן אוטומטי אם ההעברה תסתיים בהצלחה.
INVALID_PIN המשתמש סיפק קוד אימות לא חוקי.
OS_LOCK_FAILED בתהליך התשלום הזה יש צורך באתגר נעילת מערכת הפעלה, והמשתמש לא הצליח לבטל את נעילת המכשיר.
PIN_ENTRY_ATTEMPTS_EXHAUSTED בתהליך התשלום הזה צריך להזין את קוד האימות של המשתמש. המשתמש לא הזין קוד אימות מספיק פעמים כדי לנסות שוב.
USER_EXITED_PAYMENT_FLOW המשתמש ביטל את כל ניסיון התשלום (בנעילת מערכת ההפעלה או במסך הזנת קוד האימות).
MONTHLY_FREQUENCY_LIMIT_EXCEEDED לא ניתן להשתמש בחשבון של משתמש לביצוע רכישות כרגע, כי יש חריגה ממגבלת הניסיון החודשי של עסקאות.
DECLINED_BY_ISSUER

אין להשתמש בקוד הדחייה במצב יציב. הקוד משמש כקוד מאסף (catch-all) זמני לשימוש כאשר המשלב נתקל בקוד דחייה לא ידוע מהמנפיק של אמצעי התשלום של המשתמש. אפשר להשתמש בקוד התוצאה הזה בזמן שהשילוב קובע קוד תוצאה מתאים יותר לשימוש או במשא ומתן על הוספת קוד תוצאה חדש למפרט הזה.

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

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

תוצאה גולמית

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

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

string

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

string

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

קוד של תוצאות של צילום תוצאה

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

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