Method: externaltransactions.refundexternaltransaction

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

คำขอ HTTP

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

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

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

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

string

ต้องระบุ ชื่อธุรกรรมภายนอกที่จะคืนเงิน รูปแบบ: แอปพลิเคชัน/{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

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

object (Price)

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

FullRefund

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

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