- แหล่งข้อมูล: ExternalTransaction
- ExternalTransactionTestPurchase
- OneTimeExternalTransaction
- RecurringExternalTransaction
- ExternalTransactionProgram
- ExternalSubscription
- SubscriptionType
- OtherRecurringProduct
- TransactionState
- ExternalTransactionAddress
- ExternalOfferInitialAcquisitionDetails
- เมธอด
ทรัพยากร: ExternalTransaction
รายละเอียดของธุรกรรมภายนอก
การแสดง JSON |
---|
{ "packageName": string, "externalTransactionId": string, "originalPreTaxAmount": { object ( |
ช่อง | |
---|---|
packageName |
เอาต์พุตเท่านั้น ชื่อทรัพยากรของธุรกรรมภายนอก ชื่อแพ็กเกจของแอปพลิเคชันที่มีการขายไอเทมที่ซื้อในแอป (เช่น "com.some.app") |
externalTransactionId |
เอาต์พุตเท่านั้น รหัสของธุรกรรมนี้ รหัสธุรกรรมทั้งหมดภายใต้ชื่อแพ็กเกจเดียวกันต้องไม่ซ้ำกัน ตั้งค่าเมื่อสร้างธุรกรรมภายนอก |
originalPreTaxAmount |
ต้องระบุ จำนวนเงินเดิมของธุรกรรมก่อนหักภาษี จำนวนนี้เป็นราคาก่อนหักภาษีซึ่งเดิมที่แจ้งไปยัง Google ก่อนที่จะมีการคืนเงิน |
originalTaxAmount |
ต้องระบุ จำนวนเงินภาษีเดิม จำนวนนี้เป็นจำนวนภาษีที่แจ้งไปยัง Google ในตอนแรกก่อนที่จะมีการคืนเงิน |
currentPreTaxAmount |
เอาต์พุตเท่านั้น จำนวนเงินของธุรกรรมปัจจุบันไม่รวมภาษี จำนวนนี้คือจำนวนก่อนหักภาษีปัจจุบัน รวมถึงเงินคืนที่อาจมีผลกับธุรกรรมนี้ |
currentTaxAmount |
เอาต์พุตเท่านั้น จำนวนเงินภาษีปัจจุบัน จำนวนนี้คือจำนวนภาษีปัจจุบัน รวมถึงเงินคืนที่อาจมีผลกับธุรกรรมนี้ |
testPurchase |
เอาต์พุตเท่านั้น หากตั้งค่าไว้ แสดงว่าธุรกรรมนี้เป็นการซื้อทดสอบ Google จะไม่เรียกเก็บเงินสำหรับธุรกรรมทดสอบ |
transactionTime |
ต้องระบุ เวลาที่ทำธุรกรรมเสร็จสมบูรณ์ การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: |
createTime |
เอาต์พุตเท่านั้น เวลาที่สร้างธุรกรรมนี้ นี่คือเวลาที่ Google ได้รับการแจ้งเตือนเกี่ยวกับธุรกรรม การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: |
transactionState |
เอาต์พุตเท่านั้น สถานะปัจจุบันของธุรกรรม |
userTaxAddress |
ต้องระบุ ที่อยู่ของผู้ใช้สำหรับการคำนวณภาษี |
transactionProgramCode |
ไม่บังคับ รหัสโปรแกรมธุรกรรม ซึ่งใช้เพื่อช่วยกำหนดค่าบริการสำหรับแอปที่มีสิทธิ์ซึ่งเข้าร่วมโปรแกรมพาร์ทเนอร์ นักพัฒนาแอปที่เข้าร่วมโปรแกรม Play Media Experience Program (https://play.google.com/console/about/programs/mediaprogram/) ต้องระบุรหัสของโปรแกรมเมื่อรายงานธุรกรรมการเรียกเก็บเงินระบบอื่น หากคุณเป็นนักพัฒนาแอปที่มีสิทธิ์ โปรดติดต่อ BDM เพื่อขอข้อมูลเพิ่มเติมเกี่ยวกับวิธีตั้งค่าช่องนี้ หมายเหตุ: ช่องนี้ใช้กับธุรกรรมของข้อเสนอภายนอกไม่ได้ |
externalOfferInitialAcquisitionDetails |
ไม่บังคับ รายละเอียดเกี่ยวกับครั้งแรกที่ผู้ใช้/อุปกรณ์ทำธุรกรรมโดยใช้ข้อเสนอภายนอก ไม่จำเป็นสำหรับธุรกรรมที่ดำเนินการโดยใช้การเรียกเก็บเงินแบบให้ผู้ใช้ตัดสินใจหรือการเรียกเก็บเงินระบบอื่นเท่านั้น |
ช่องการรวม transaction_type ประเภทของธุรกรรมที่ทำ transaction_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ |
|
oneTimeTransaction |
นี่คือธุรกรรมแบบครั้งเดียว ไม่ใช่ส่วนหนึ่งของการสมัครรับข้อมูล |
recurringTransaction |
ธุรกรรมนี้เป็นส่วนหนึ่งของชุดธุรกรรมที่เกิดซ้ำ |
ExternalTransactionTestPurchase
ประเภทนี้ไม่มีช่อง
แสดงธุรกรรมที่ดำเนินการโดยใช้บัญชีทดสอบ Google จะไม่เรียกเก็บเงินจากธุรกรรมเหล่านี้
OneTimeExternalTransaction
แสดงธุรกรรมแบบครั้งเดียว
การแสดง JSON |
---|
{ "externalTransactionToken": string } |
ช่อง | |
---|---|
externalTransactionToken |
อินพุตเท่านั้น ซึ่งระบุระหว่างการเรียกใช้ Create ดึงจากลูกค้าเมื่อมีการเปิดใช้ขั้นตอนการเรียกเก็บเงินระบบอื่น |
RecurringExternalTransaction
หมายถึงธุรกรรมที่เป็นส่วนหนึ่งของชุดการชำระเงินตามรอบ ซึ่งอาจเป็นการสมัครใช้บริการหรือผลิตภัณฑ์แบบครั้งเดียวที่มีการชำระเงินหลายครั้ง (เช่น การสั่งจองล่วงหน้า)
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่องการรวม
|
|
initialExternalTransactionId |
รหัสธุรกรรมภายนอกของธุรกรรมแรกของชุดธุรกรรมที่เกิดซ้ำนี้ เช่น สำหรับการสมัครใช้บริการ จะเป็นรหัสธุรกรรมของการชำระเงินครั้งแรก ต้องระบุเมื่อสร้างธุรกรรมภายนอกที่เกิดซ้ำ |
externalTransactionToken |
อินพุตเท่านั้น ซึ่งระบุระหว่างการเรียกใช้ Create ดึงจากลูกค้าเมื่อมีการเปิดใช้ขั้นตอนการเรียกเก็บเงินระบบอื่น จำเป็นสำหรับการซื้อครั้งแรกเท่านั้น |
migratedTransactionProgram |
อินพุตเท่านั้น ซึ่งระบุระหว่างการเรียกใช้ Create ต้องใช้เมื่อย้ายข้อมูลการสมัครใช้บริการจากการรายงานรายเดือนด้วยตนเองไปเป็นการรายงานอัตโนมัติเท่านั้น |
ช่องการรวม product_details ต้องระบุ รายละเอียดของผลิตภัณฑ์ในธุรกรรมภายนอกตามรอบ product_details ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ |
|
externalSubscription |
รายละเอียดการสมัครใช้บริการภายนอก |
otherRecurringProduct |
รายละเอียดของผลิตภัณฑ์การทำธุรกรรมภายนอกที่เกิดขึ้นประจำซึ่งไม่ได้อยู่ในหมวดหมู่เฉพาะอื่นใด |
ExternalTransactionProgram
แสดงโปรแกรมธุรกรรมภายนอกที่ผู้ใช้ใช้ในการทำธุรกรรมให้เสร็จสมบูรณ์
Enum | |
---|---|
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED |
โปรแกรมธุรกรรมที่ไม่ระบุ ไม่ใช้ |
USER_CHOICE_BILLING |
การเรียกเก็บเงินแบบให้ผู้ใช้ตัดสินใจ ซึ่งผู้ใช้สามารถเลือกระหว่างการเรียกเก็บเงินที่จัดการโดยนักพัฒนาแอปของ Google Play Billing |
ALTERNATIVE_BILLING_ONLY |
การเรียกเก็บเงินระบบอื่นเท่านั้น ซึ่งผู้ใช้จะใช้ได้เฉพาะการเรียกเก็บเงินสำหรับนักพัฒนาแอป-ผู้จัดการเท่านั้น |
ExternalSubscription
รายละเอียดการสมัครใช้บริการภายนอก
การแสดง JSON |
---|
{
"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 |
ต้องระบุ รหัสภูมิภาค 2 ตัวอักษรตามมาตรฐาน ISO-3166-1 Alpha-2 (รหัสภูมิภาค UN) |
administrativeArea |
ไม่บังคับ เขตบริหารย่อยระดับสูงสุดของประเทศ/ภูมิภาค จำเป็นสำหรับการทำธุรกรรมในอินเดียเท่านั้น ค่าที่ใช้ได้คือ |
ExternalOfferInitialAcquisitionDetails
รายละเอียดเกี่ยวกับครั้งแรกที่ผู้ใช้/อุปกรณ์ทำธุรกรรมโดยใช้ข้อเสนอภายนอก
การแสดง JSON |
---|
{ "externalTransactionId": string } |
ช่อง | |
---|---|
externalTransactionId |
ต้องระบุ รหัสธุรกรรมภายนอกของการซื้อที่เสร็จสมบูรณ์ครั้งแรกโดยผู้ใช้ |
เมธอด |
|
---|---|
|
สร้างธุรกรรมภายนอกใหม่ |
|
รับธุรกรรมภายนอกที่มีอยู่ |
|
คืนเงินหรือคืนเงินบางส่วนให้กับธุรกรรมภายนอกที่มีอยู่ |