Method: externaltransactions.refundexternaltransaction

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

בקשת HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/{name=applications/*/externalTransactions/*}:refund

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
name

string

חובה. שם העסקה החיצונית שרוצים לקבל עליה החזר כספי. פורמט: Applications/{packageName}/externalTransactions/{externalTransaction}

גוף הבקשה

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

ייצוג JSON 
{
  "refundTime": string,

  // Union field refund_type can be only one of the following:
  "partialRefund": {
    object (PartialRefund)
  },
  "fullRefund": {
    object (FullRefund)
  }
  // End of list of possible types for union field refund_type.
}
שדות
refundTime

string (Timestamp format)

חובה. המועד שבו בוצע החזר כספי על העסקה.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
שדה איחוד refund_type. חובה. סוג ההחזר הכספי על העסקה החיצונית. refund_type יכול להיות רק אחת מהאפשרויות הבאות:
partialRefund

object (PartialRefund)

ניתן החזר כספי חלקי.
fullRefund

object (FullRefund)

החזר כספי מלא.

גוף התשובה

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

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/androidpublisher

PartialRefund

החזר כספי חלקי על עסקה.

ייצוג JSON 
{
  "refundId": string,
  "refundPreTaxAmount": {
    object (Price)
  }
}
שדות
refundId

string

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

object (Price)

חובה. הסכום של ההחזר הכספי החלקי לפני מס. הסכום צריך להיות נמוך מהסכום הנותר של העסקה לפני מס.

FullRefund

אין שדות בסוג הזה.

החזר כספי מלא של סכום העסקה שנותר.