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" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 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

ต้องระบุ รหัสที่ไม่ซ้ำกันซึ่งแยกแยะการคืนเงินบางส่วนนี้ หากคืนเงินสำเร็จ การคืนเงินครั้งต่อๆ ไปที่มีรหัสเดียวกันจะไม่สำเร็จ ต้องไม่ซ้ำกันสำหรับการคืนเงินของธุรกรรมแต่ละรายการ
refundPreTaxAmount

object (Price)

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

FullRefund

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

การคืนเงินเต็มจำนวนสำหรับยอดคงเหลือของธุรกรรม