Method: externaltransactions.refundexternaltransaction

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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

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

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