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, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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

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

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