- منبع: ExternalTransaction
- External TransactionTestPurchase
- OneTimeExternal Transaction
- تراکنش خارجی تکرارشونده
- برنامه تراکنش خارجی
- اشتراک خارجی
- نوع اشتراک
- سایر محصولات تکرار شونده
- وضعیت معامله
- آدرس تراکنش خارجی
- مواد و روش ها
منبع: ExternalTransaction
جزئیات یک تراکنش خارجی
نمایندگی JSON |
---|
{ "packageName": string, "externalTransactionId": string, "originalPreTaxAmount": { object ( |
زمینه های | |
---|---|
packageName | فقط خروجی نام منبع تراکنش خارجی. نام بسته برنامه محصولات inapp فروخته شد (به عنوان مثال، 'com.some.app'). |
externalTransactionId | فقط خروجی شناسه این معامله همه شناسههای تراکنش تحت یک نام بسته باید منحصربهفرد باشند. هنگام ایجاد تراکنش خارجی تنظیم کنید. |
originalPreTaxAmount | ضروری. مبلغ اصلی معامله قبل از مالیات. این نشان دهنده مبلغ پیش از مالیات است که ابتدا قبل از اعمال بازپرداخت به Google اطلاع داده شده است. |
originalTaxAmount | ضروری. مبلغ اصلی مالیات این مبلغ مالیاتی است که ابتدا قبل از اعمال بازپرداخت به Google اطلاع داده شده است. |
currentPreTaxAmount | فقط خروجی مبلغ معامله جاری قبل از مالیات. این مبلغ پیش از مالیات فعلی از جمله هرگونه بازپرداختی است که ممکن است برای این تراکنش اعمال شده باشد. |
currentTaxAmount | فقط خروجی مبلغ مالیات فعلی این مبلغ مالیات فعلی از جمله هرگونه بازپرداختی است که ممکن است برای این تراکنش اعمال شده باشد. |
testPurchase | فقط خروجی در صورت تنظیم، این تراکنش یک خرید آزمایشی بود. Google برای تراکنش آزمایشی هزینه ای دریافت نمی کند. |
transactionTime | ضروری. زمانی که معامله انجام شد. مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثالها: |
createTime | فقط خروجی زمانی که این معامله ایجاد شد. این زمانی است که گوگل از تراکنش مطلع شد. مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثالها: |
transactionState | فقط خروجی وضعیت فعلی معامله. |
userTaxAddress | ضروری. آدرس کاربر برای محاسبه مالیات |
transaction_type فیلد اتحادیه نوع معامله ای که انجام شد. transaction_type تنها می تواند یکی از موارد زیر باشد: | |
oneTimeTransaction | این یک تراکنش یک بار است و بخشی از یک اشتراک نیست. |
recurringTransaction | این تراکنش بخشی از یک سری معاملات تکراری است. |
External TransactionTestPurchase
این نوع هیچ فیلدی ندارد.
نشان دهنده تراکنشی است که با استفاده از یک حساب آزمایشی انجام شده است. این تراکنشها توسط Google کسر نمیشوند.
OneTimeExternal Transaction
نشان دهنده یک معامله یکباره است.
نمایندگی JSON |
---|
{ "externalTransactionToken": string } |
زمینه های | |
---|---|
externalTransactionToken | فقط ورودی ارائه شده در طول تماس برای ایجاد. هنگامی که جریان صورتحساب جایگزین راه اندازی شد، از مشتری بازیابی می شود. |
تراکنش خارجی تکرارشونده
تراکنشی را نشان می دهد که بخشی از یک سری پرداخت های تکراری است. این می تواند یک اشتراک یا یک محصول یک بار مصرف با پرداخت های متعدد (مانند پیش سفارش) باشد.
نمایندگی JSON |
---|
{ // Union field |
زمینه های | |
---|---|
| |
initialExternalTransactionId | شناسه تراکنش خارجی اولین تراکنش از این سری معاملات تکراری. به عنوان مثال، برای یک اشتراک، این شناسه تراکنش اولین پرداخت خواهد بود. هنگام ایجاد تراکنش های خارجی تکرار شونده لازم است. |
externalTransactionToken | فقط ورودی ارائه شده در طول تماس برای ایجاد. هنگامی که جریان صورتحساب جایگزین راه اندازی شد، از مشتری بازیابی می شود. فقط برای خرید اولیه مورد نیاز است. |
migratedTransactionProgram | فقط ورودی ارائه شده در طول تماس برای ایجاد. فقط باید هنگام انتقال اشتراک از گزارش دستی ماهانه به گزارش خودکار استفاده شود. |
product_details میدان اتحادیه ضروری. جزئیات محصول در تراکنش خارجی مکرر. product_details فقط می تواند یکی از موارد زیر باشد: | |
externalSubscription | جزئیات یک اشتراک خارجی |
otherRecurringProduct | جزئیات یک محصول تراکنش خارجی تکرارشونده که به هیچ دسته خاص دیگری تعلق ندارد. |
برنامه تراکنش خارجی
نشان دهنده برنامه تراکنش خارجی است که کاربر برای تکمیل تراکنش تجربه کرده است.
Enums | |
---|---|
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED | برنامه تراکنش نامشخص استفاده نشده. |
USER_CHOICE_BILLING | صورتحساب انتخاب کاربر، که در آن کاربر میتواند بین صورتحساب Google Play Billing که توسط برنامهنویس مدیریت میشود، یکی را انتخاب کند. |
ALTERNATIVE_BILLING_ONLY | فقط صورتحساب جایگزین، که در آن کاربران فقط میتوانند از صورتحساب مدیر برنامهنویس استفاده کنند. |
اشتراک خارجی
جزئیات یک اشتراک خارجی
نمایندگی JSON |
---|
{
"subscriptionType": enum ( |
زمینه های | |
---|---|
subscriptionType | ضروری. نوع اشتراک خارجی |
نوع اشتراک
انواع اشتراک خارجی
Enums | |
---|---|
SUBSCRIPTION_TYPE_UNSPECIFIED | نامشخص، استفاده نکنید. |
RECURRING | این یک اشتراک مکرر است که در آن کاربر در هر چرخه صورتحساب هزینه دریافت می کند. |
PREPAID | این یک اشتراک پیش پرداخت است که در آن کاربر از قبل پرداخت می کند. |
سایر محصولات تکرار شونده
این نوع هیچ فیلدی ندارد.
جزئیات یک محصول تراکنش خارجی تکرارشونده که به دسته خاص دیگری تعلق ندارد.
وضعیت معامله
وضعیت معامله در حال انجام
Enums | |
---|---|
TRANSACTION_STATE_UNSPECIFIED | وضعیت معامله نامشخص استفاده نشده. |
TRANSACTION_REPORTED | این تراکنش با موفقیت به Google گزارش شده است. |
TRANSACTION_CANCELED | تراکنش به طور کامل بازپرداخت شده است. |
آدرس تراکنش خارجی
آدرس کاربر برای تراکنش خارجی.
نمایندگی JSON |
---|
{ "regionCode": string, "administrativeArea": string } |
زمینه های | |
---|---|
regionCode | ضروری. کد منطقه دو حرفی بر اساس ISO-3166-1 Alpha-2 (کدهای منطقه سازمان ملل). |
administrativeArea | اختیاری. زیرمجموعه اداری سطح بالا کشور/منطقه. فقط برای معاملات در هند مورد نیاز است. مقادیر معتبر عبارتند از: «جزیره اندامان و نیکوبار»، «آندرا پرادش»، «آروناچال پرادش»، «اسام»، «بیهار»، «چندیگره»، «چاتیسگاره»، «دادرا و نگار هاولی»، «دادرا و نگار هاولی اندامن» AND DIU، "DAMAN AND DIU"، "DELHI"، "GOA"، "Gujarat"، "Haryana"، "HIMACHAL PRADESH"، "JAMMU and Kashmir"، "Jharkhand"، "KARNATAKA"، "KERALA"، " LADAKH، "LAKSHADWEEP"، "MADHYA PRADESH"، "MAHARASHTRA"، "MANIPUR"، "MEGHALAYA"، "MIZORAM"، "NAGALAND"، "ODISHA"، "PUDUCHERRY"، "Punjab"، "راجستان"، "SIKKIM" "، "TAMIL NADU"، "TELANGANA"، "TRIPURA"، "UTTAR PRADESH"، "UTTARAKHAND"، و "West Bengal". |
مواد و روش ها | |
---|---|
| یک تراکنش خارجی جدید ایجاد می کند. |
| تراکنش خارجی موجود را دریافت می کند. |
| بازپرداخت یا بازپرداخت جزئی یک تراکنش خارجی موجود. |