REST Resource: externaltransactions

ทรัพยากร: ExternalTransaction

รายละเอียดของธุรกรรมภายนอก

การแสดง JSON 
{
  "packageName": string,
  "externalTransactionId": string,
  "originalPreTaxAmount": {
    object (Price)
  },
  "originalTaxAmount": {
    object (Price)
  },
  "currentPreTaxAmount": {
    object (Price)
  },
  "currentTaxAmount": {
    object (Price)
  },
  "testPurchase": {
    object (ExternalTransactionTestPurchase)
  },
  "transactionTime": string,
  "createTime": string,
  "transactionState": enum (TransactionState),
  "userTaxAddress": {
    object (ExternalTransactionAddress)
  },

  // Union field transaction_type can be only one of the following:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of list of possible types for union field transaction_type.
}
ช่อง
packageName

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของธุรกรรมภายนอก ชื่อแพ็กเกจของแอปพลิเคชันที่มีการขายไอเทมที่ซื้อในแอป (เช่น "com.some.app")
externalTransactionId

string

เอาต์พุตเท่านั้น รหัสของธุรกรรมนี้ รหัสธุรกรรมทั้งหมดภายใต้ชื่อแพ็กเกจเดียวกันจะต้องไม่ซ้ำกัน กำหนดเมื่อสร้างธุรกรรมภายนอก
originalPreTaxAmount

object (Price)

ต้องระบุ จำนวนเงินเดิมของธุรกรรม (ไม่รวมภาษี) ตัวเลขนี้คือจำนวนเงินก่อนหักภาษีที่แจ้งไปยัง Google ในตอนแรกก่อนที่จะมีการคืนเงิน
originalTaxAmount

object (Price)

ต้องระบุ จำนวนภาษีเดิม ตัวเลขนี้คือจํานวนภาษีที่แจ้งให้ Google ทราบในตอนแรกก่อนที่จะมีการคืนเงิน
currentPreTaxAmount

object (Price)

เอาต์พุตเท่านั้น จำนวนเงินของธุรกรรมปัจจุบัน (ไม่รวมภาษี) ค่านี้แสดงจำนวนเงินปัจจุบันก่อนหักภาษี รวมถึงเงินคืนใดๆ ที่อาจมีผลกับธุรกรรมนี้
currentTaxAmount

object (Price)

เอาต์พุตเท่านั้น จํานวนภาษีปัจจุบัน ค่านี้แสดงจำนวนเงินภาษีปัจจุบัน รวมถึงการคืนเงินใดๆ ที่อาจมีผลกับธุรกรรมนี้
testPurchase

object (ExternalTransactionTestPurchase)

เอาต์พุตเท่านั้น หากมีการตั้งค่า ธุรกรรมนี้เป็นการซื้อทดสอบ Google จะไม่เรียกเก็บเงินสำหรับธุรกรรมทดสอบ
transactionTime

string (Timestamp format)

ต้องระบุ เวลาที่ธุรกรรมเสร็จสมบูรณ์

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
createTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่สร้างธุรกรรมนี้ ซึ่งเป็นเวลาที่ Google ได้รับการแจ้งเตือนเกี่ยวกับธุรกรรม

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
transactionState

enum (TransactionState)

เอาต์พุตเท่านั้น สถานะปัจจุบันของธุรกรรม
userTaxAddress

object (ExternalTransactionAddress)

ต้องระบุ ที่อยู่ผู้ใช้สำหรับการคำนวณภาษี
ฟิลด์สหภาพ transaction_type ประเภทของธุรกรรมที่ได้ดำเนินการ transaction_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
oneTimeTransaction

object (OneTimeExternalTransaction)

นี่เป็นธุรกรรมแบบครั้งเดียว ไม่ใช่ส่วนหนึ่งของการสมัครใช้บริการ
recurringTransaction

object (RecurringExternalTransaction)

ธุรกรรมนี้เป็นส่วนหนึ่งของชุดธุรกรรมที่เกิดซ้ำ

ExternalTransactionTestPurchase

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

แสดงธุรกรรมที่ดำเนินการโดยใช้บัญชีทดสอบ Google จะไม่เรียกเก็บเงินจากธุรกรรมเหล่านี้

OneTimeExternalTransaction

แสดงธุรกรรมแบบครั้งเดียว

การแสดง JSON 
{
  "externalTransactionToken": string
}
ช่อง
externalTransactionToken

string

อินพุตเท่านั้น ระบุไว้ระหว่างการโทรไปยัง Create เรียกข้อมูลจากลูกค้าเมื่อมีการเปิดใช้ขั้นตอนการเรียกเก็บเงินระบบอื่น

RecurringExternalTransaction

แสดงธุรกรรมที่เป็นส่วนหนึ่งของชุดการชำระเงินตามรอบ โดยอาจเป็นการสมัครใช้บริการหรือผลิตภัณฑ์แบบครั้งเดียวที่มีการชำระเงินหลายครั้ง (เช่น สั่งล่วงหน้า)

การแสดง JSON 
{

  // Union field source can be only one of the following:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of list of possible types for union field source.

  // Union field product_details can be only one of the following:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of list of possible types for union field product_details.
}
ช่อง

ฟิลด์สหภาพ source

source ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
initialExternalTransactionId

string

รหัสธุรกรรมภายนอกของธุรกรรมครั้งแรกของธุรกรรมที่เกิดซ้ำนี้ เช่น สำหรับการสมัครใช้บริการ รหัสนี้จะเป็นรหัสธุรกรรมของการชำระเงินครั้งแรก ต้องระบุเมื่อสร้างธุรกรรมภายนอกที่เกิดซ้ำ
externalTransactionToken

string

อินพุตเท่านั้น ระบุไว้ระหว่างการโทรไปยัง Create เรียกข้อมูลจากลูกค้าเมื่อมีการเปิดใช้ขั้นตอนการเรียกเก็บเงินระบบอื่น ต้องใช้สำหรับการซื้อครั้งแรกเท่านั้น
migratedTransactionProgram

enum (ExternalTransactionProgram)

อินพุตเท่านั้น ระบุไว้ระหว่างการโทรไปยัง Create ต้องใช้เมื่อย้ายข้อมูลการสมัครใช้บริการจากการรายงานรายเดือนด้วยตนเองไปเป็นการรายงานอัตโนมัติเท่านั้น
ฟิลด์สหภาพ product_details ต้องระบุ รายละเอียดของผลิตภัณฑ์ในธุรกรรมภายนอกที่เกิดซ้ำ product_details ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
externalSubscription

object (ExternalSubscription)

รายละเอียดการสมัครใช้บริการภายนอก
otherRecurringProduct

object (OtherRecurringProduct)

รายละเอียดของผลิตภัณฑ์ธุรกรรมภายนอกตามรอบที่ไม่ได้อยู่ในหมวดหมู่เฉพาะอื่นใด

ExternalTransactionProgram

หมายถึงโปรแกรมธุรกรรมภายนอกที่ผู้ใช้ประสบในการทำธุรกรรมให้เสร็จสมบูรณ์

Enum
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED โปรแกรมธุรกรรมที่ไม่ระบุ ไม่ได้ใช้
USER_CHOICE_BILLING การเรียกเก็บเงินแบบให้ผู้ใช้ตัดสินใจ ซึ่งผู้ใช้สามารถเลือกระหว่างการเรียกเก็บเงินที่จัดการโดยนักพัฒนาแอปของ Google Play Billing
ALTERNATIVE_BILLING_ONLY การเรียกเก็บเงินระบบอื่นเท่านั้น ซึ่งผู้ใช้จะใช้การเรียกเก็บเงินของนักพัฒนาแอป-บัญชีดูแลจัดการได้เท่านั้น

ExternalSubscription

รายละเอียดการสมัครใช้บริการภายนอก

การแสดง JSON 
{
  "subscriptionType": enum (SubscriptionType)
}
ช่อง
subscriptionType

enum (SubscriptionType)

ต้องระบุ ประเภทของการสมัครใช้บริการภายนอก

SubscriptionType

ประเภทของการสมัครใช้บริการภายนอก

Enum
SUBSCRIPTION_TYPE_UNSPECIFIED ไม่ระบุ ห้ามใช้
RECURRING เป็นการสมัครใช้บริการที่เกิดซ้ำ ซึ่งจะมีการเรียกเก็บเงินจากผู้ใช้ทุกรอบการเรียกเก็บเงิน
PREPAID ซึ่งเป็นการสมัครใช้บริการแบบชำระล่วงหน้าที่ผู้ใช้ชำระเงินล่วงหน้า

OtherRecurringProduct

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

รายละเอียดของผลิตภัณฑ์ธุรกรรมภายนอกตามรอบที่ไม่ได้จัดอยู่ในหมวดหมู่ที่เฉพาะเจาะจงอื่นๆ

TransactionState

สถานะการทำธุรกรรมที่กำลังดำเนินการ

Enum
TRANSACTION_STATE_UNSPECIFIED สถานะธุรกรรมที่ไม่ระบุ ไม่ได้ใช้
TRANSACTION_REPORTED รายงานธุรกรรมไปยัง Google เรียบร้อยแล้ว
TRANSACTION_CANCELED ธุรกรรมได้รับการคืนเงินเต็มจำนวนแล้ว

ExternalTransactionAddress

อีเมลของผู้ใช้สำหรับธุรกรรมภายนอก

การแสดง JSON 
{
  "regionCode": string,
  "administrativeArea": string
}
ช่อง
regionCode

string

ต้องระบุ รหัสภูมิภาคแบบ 2 ตัวอักษรตามมาตรฐาน ISO-3166-1 Alpha-2 (รหัสภูมิภาค UN)
administrativeArea

string

ไม่บังคับ เขตปกครองระดับบนสุดของประเทศ/ภูมิภาค จำเป็นสำหรับธุรกรรมในอินเดียเท่านั้น "กรุงเทพ", "กรุงเทพ", "กรุงเทพ", "ปทุมวัน", "กรุงเทพฯ",

วิธีการ

createexternaltransaction

 สร้างธุรกรรมภายนอกรายการใหม่

getexternaltransaction

 รับธุรกรรมภายนอกที่มีอยู่

refundexternaltransaction

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