- แหล่งข้อมูล: ExternalTransaction
- ExternalTransactionTestPurchase
- OneTimeExternalTransaction
- RecurringExternalTransaction
- ExternalTransactionProgram
- ExternalSubscription
- SubscriptionType
- OtherRecurringProduct
- TransactionState
- ExternalTransactionAddress
- เมธอด
ทรัพยากร: 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 |
ต้องระบุ ที่อยู่ผู้ใช้สำหรับการคำนวณภาษี |
ฟิลด์สหภาพ 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 |
ไม่บังคับ เขตปกครองระดับบนสุดของประเทศ/ภูมิภาค จำเป็นสำหรับธุรกรรมในอินเดียเท่านั้น "กรุงเทพ", "กรุงเทพ", "กรุงเทพ", "ปทุมวัน", "กรุงเทพฯ", |
วิธีการ |
|
---|---|
|
สร้างธุรกรรมภายนอกรายการใหม่ |
|
รับธุรกรรมภายนอกที่มีอยู่ |
|
การคืนเงินหรือคืนเงินบางส่วนสำหรับธุรกรรมภายนอกที่มีอยู่ |