Method: externaltransactions.refundexternaltransaction

การคืนเงินหรือคืนเงินบางส่วนสำหรับธุรกรรมภายนอกที่มีอยู่

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
name

string

ต้องระบุ ชื่อของธุรกรรมภายนอกที่จะได้รับเงินคืน รูปแบบ: application/{packageName}/externalTransaction/{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" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "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

ต้องระบุ รหัสที่ไม่ซ้ำกันซึ่งแยกการคืนเงินบางส่วนนี้ หากคืนเงินสําเร็จ การคืนเงินโดยใช้รหัสเดียวกันในภายหลังจะไม่สําเร็จ ต้องไม่ซ้ำกันในการคืนเงินสำหรับธุรกรรม 1 รายการ
refundPreTaxAmount

object (Price)

ต้องระบุ จำนวนเงินก่อนหักภาษีของเงินคืนบางส่วน ควรน้อยกว่าจำนวนเงินที่เหลือก่อนหักภาษีของธุรกรรม

FullRefund

ประเภทนี้ไม่มีช่อง

การคืนเงินเต็มจำนวนของจำนวนเงินที่เหลือของธุรกรรม