REST Resource: externaltransactions

Resource: ExternalTransaction

Detail transaksi eksternal.

Representasi 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)
  },
  "transactionProgramCode": integer,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "externalOfferDetails": {
    object (ExternalOfferDetails)
  },
  "externalContentLinkDetails": {
    object (ExternalContentLinkDetails)
  }
  // End of mutually exclusive fields.
}
Kolom
packageName

string

Hanya output. Nama resource transaksi eksternal. Nama paket aplikasi tempat produk dalam aplikasi dijual (misalnya, 'com.some.app').
externalTransactionId

string

Hanya output. ID transaksi ini. Semua ID transaksi di bawah nama paket yang sama harus unik. Ditetapkan saat membuat transaksi eksternal.
originalPreTaxAmount

object (Price)

Wajib. Jumlah transaksi asli sebelum pajak. Merupakan jumlah sebelum pajak yang awalnya diberitahukan kepada Google sebelum pengembalian dana diterapkan.
originalTaxAmount

object (Price)

Wajib. Jumlah pajak awal. Merupakan jumlah pajak yang awalnya diberitahukan kepada Google sebelum pengembalian dana diterapkan.
currentPreTaxAmount

object (Price)

Hanya output. Jumlah transaksi saat ini sebelum pajak. Merupakan jumlah sebelum pajak saat ini termasuk pengembalian dana apa pun yang mungkin telah diterapkan pada transaksi ini.
currentTaxAmount

object (Price)

Hanya output. Jumlah pajak saat ini. Merupakan jumlah pajak saat ini termasuk pengembalian dana apa pun yang mungkin telah diterapkan ke transaksi ini.
testPurchase

object (ExternalTransactionTestPurchase)

Hanya output. Jika disetel, transaksi ini merupakan pembelian percobaan. Google tidak akan mengenakan biaya untuk transaksi percobaan.
transactionTime

string (Timestamp format)

Wajib. Waktu ketika transaksi diselesaikan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
createTime

string (Timestamp format)

Hanya output. Waktu saat transaksi ini dibuat. Merupakan waktu ketika Google diberi tahu tentang transaksi ini.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
transactionState

enum (TransactionState)

Hanya output. Status transaksi saat ini.
userTaxAddress

object (ExternalTransactionAddress)

Wajib. Alamat pengguna untuk perhitungan pajak.
transactionProgramCode

integer

Opsional. Kode program transaksi, yang digunakan untuk membantu menentukan biaya layanan bagi aplikasi yang memenuhi syarat yang berpartisipasi dalam program partner. Developer yang berpartisipasi dalam Program Pengalaman Media Play (https://play.google.com/console/about/programs/mediaprogram/) harus memberikan kode program saat melaporkan transaksi penagihan alternatif. Jika Anda adalah pengembang yang memenuhi syarat, silakan hubungi BDM Anda untuk informasi lebih lanjut tentang cara mengatur bidang ini. Catatan: kolom ini tidak dapat digunakan untuk transaksi penawaran eksternal.
Jenis transaksi yang dilakukan. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
oneTimeTransaction

object (OneTimeExternalTransaction)

Transaksi ini adalah transaksi satu kali dan bukan bagian dari langganan.
recurringTransaction

object (RecurringExternalTransaction)

Transaksi ini adalah bagian dari rangkaian transaksi yang berulang.
Akhir kolom yang saling eksklusif.
Detail khusus program yang diperlukan untuk pelaporan transaksi. Detail hanya boleh ditetapkan untuk program yang terkait dengan transaksi. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
externalOfferDetails

object (ExternalOfferDetails)

Opsional. Rincian yang diperlukan untuk melaporkan transaksi penawaran eksternal secara akurat.
externalContentLinkDetails

object (ExternalContentLinkDetails)

Opsional. Detail yang diperlukan untuk melaporkan transaksi link konten eksternal secara akurat.
Akhir kolom yang saling eksklusif.

ExternalTransactionTestPurchase

Jenis ini tidak memiliki kolom.

Merupakan transaksi yang dilakukan menggunakan akun uji. Transaksi ini tidak akan dikenakan biaya oleh Google.

OneTimeExternalTransaction

Mewakili transaksi satu kali.

Representasi JSON 
{
  "externalTransactionToken": string
}
Kolom
externalTransactionToken

string

Hanya input. Diberikan selama panggilan untuk Membuat. Diambil dari klien saat alur penagihan alternatif diluncurkan.

RecurringExternalTransaction

Mewakili transaksi yang merupakan bagian dari serangkaian pembayaran berulang. Transaksi ini bisa berupa langganan atau produk sekali beli dengan beberapa pembayaran (seperti praorder).

Representasi JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of mutually exclusive fields.
}
Kolom
Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
initialExternalTransactionId

string

ID transaksi eksternal dari transaksi pertama dari rangkaian transaksi berulang ini. Sebagai contoh, untuk langganan, ini akan menjadi ID transaksi dari pembayaran pertama. Diperlukan saat membuat transaksi eksternal berulang.
externalTransactionToken

string

Hanya input. Diberikan selama panggilan untuk Membuat. Diambil dari klien saat alur penagihan alternatif diluncurkan. Hanya diperlukan untuk pembelian awal.
migratedTransactionProgram

enum (ExternalTransactionProgram)

Hanya input. Diberikan selama panggilan untuk Membuat. Hanya boleh digunakan saat memigrasikan langganan dari pelaporan bulanan manual ke pelaporan otomatis.
Akhir kolom yang saling eksklusif.
Wajib. Rincian produk dalam transaksi eksternal berulang. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
externalSubscription

object (ExternalSubscription)

Detail langganan eksternal.
otherRecurringProduct

object (OtherRecurringProduct)

Detail produk transaksi eksternal berulang yang tidak termasuk dalam kategori spesifik lainnya.
Akhir kolom yang saling eksklusif.

ExternalTransactionProgram

Merepresentasikan program transaksi eksternal yang dialami pengguna untuk menyelesaikan transaksi.

Enum
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Program transaksi yang tidak ditentukan. Tidak digunakan.
USER_CHOICE_BILLING Penagihan sesuai pilihan pengguna, di mana pengguna dapat memilih antara Layanan Penagihan Google Play atau penagihan yang dikelola developer.
ALTERNATIVE_BILLING_ONLY Hanya tersedia metode penagihan alternatif, di mana pengguna hanya dapat menggunakan penagihan pengembang-manajer.

ExternalSubscription

Detail langganan eksternal.

Representasi JSON 
{
  "subscriptionType": enum (SubscriptionType)
}
Kolom
subscriptionType

enum (SubscriptionType)

Wajib. Jenis langganan eksternal.

SubscriptionType

Jenis langganan eksternal.

Enum
SUBSCRIPTION_TYPE_UNSPECIFIED Tidak ditentukan, jangan gunakan.
RECURRING Langganan berulang di mana pengguna ditagih setiap siklus penagihan.
PREPAID Ini adalah langganan prabayar di mana pengguna membayar di muka.

OtherRecurringProduct

Jenis ini tidak memiliki kolom.

Detail produk transaksi eksternal berulang yang tidak termasuk dalam kategori lain yang lebih spesifik.

TransactionState

Status transaksi yang sedang dilakukan.

Enum
TRANSACTION_STATE_UNSPECIFIED Status transaksi tidak ditentukan. Tidak digunakan.
TRANSACTION_REPORTED Transaksi tersebut telah berhasil dilaporkan ke Google.
TRANSACTION_CANCELED Transaksi telah dikembalikan dananya sepenuhnya.

ExternalTransactionAddress

Alamat pengguna untuk transaksi eksternal.

Representasi JSON 
{
  "regionCode": string,
  "administrativeArea": string
}
Kolom
regionCode

string

Wajib. Kode wilayah dua huruf berdasarkan ISO-3166-1 Alpha-2 (kode wilayah PBB).
administrativeArea

string

Opsional. Subdivisi administratif tingkat atas negara/wilayah. Hanya diperlukan untuk transaksi di India. Nilai yang valid adalah "ANDAMAN AND NICOBAR ISLANDS", "ANDHRA PRADESH", "ARUNACHAL PRADESH", "ASSAM", "BIHAR", "CHANDIGARH", "CHHATTISGARH", "DADRA AND NAGAR HAVELI", "DADRA AND NAGAR HAVELI AND DAMAN 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", "RAJASTHAN", "SIKKIM", "TAMIL NADU", "TELANGANA", "TRIPURA", "UTTAR PRADESH", "UTTARAKHAND", dan "WEST BENGAL".

ExternalOfferDetails

Detail pelaporan yang unik untuk program penawaran eksternal.

Representasi JSON 
{
  "linkType": enum (ExternalOfferLinkType),
  "installedAppPackage": string,
  "installedAppCategory": enum (ExternalOfferAppCategory),
  "appDownloadEventExternalTransactionId": string
}
Kolom
installedAppPackage

string

Opsional. Nama paket aplikasi yang didownload melalui transaksi ini. Wajib jika linkType adalah LINK_TO_APP_DOWNLOAD.
installedAppCategory

enum (ExternalOfferAppCategory)

Opsional. Kategori aplikasi yang didownload melalui transaksi ini. Ini harus sesuai dengan kategori yang diberikan di Play Console selama proses verifikasi aplikasi eksternal. Hanya diperlukan untuk mengunduh aplikasi.
appDownloadEventExternalTransactionId

string

Opsional. ID transaksi eksternal yang terkait dengan peristiwa download aplikasi melalui link eksternal. Diperlukan saat melaporkan transaksi yang dilakukan di aplikasi yang diinstal secara eksternal.

ExternalOfferLinkType

Jenis link eksternal.

Enum
LINK_TO_DIGITAL_CONTENT_OFFER Penawaran untuk membeli konten digital.

ExternalOfferAppCategory

Kategori aplikasi yang diunduh. Lihat https://support.google.com/googleplay/android-developer/answer/9859673 untuk informasi lebih lanjut tentang kategori aplikasi.

Enum
EXTERNAL_OFFER_APP_CATEGORY_UNSPECIFIED Tidak ditentukan, jangan gunakan.
APP Aplikasi ini diklasifikasikan dalam kategori aplikasi.
GAME Aplikasi diklasifikasikan dalam kategori game.

ExternalContentLinkDetails

Detail pelaporan yang unik untuk program link konten eksternal.

Representasi JSON 
{
  "linkType": enum (ExternalContentLinkType),
  "installedAppPackage": string,
  "externalAppCategory": enum (ExternalContentAppCategory)
}
Kolom
installedAppPackage

string

Opsional. Nama paket aplikasi yang didownload melalui transaksi ini. Hanya diperlukan untuk penginstalan aplikasi.
externalAppCategory

enum (ExternalContentAppCategory)

Opsional. Kategori aplikasi yang diunduh. Kategori ini harus sesuai dengan kategori yang diberikan di Play Console selama proses verifikasi aplikasi eksternal. Hanya diperlukan untuk penginstalan aplikasi.

ExternalContentLinkType

Jenis tautan eksternal.

Enum
EXTERNAL_CONTENT_LINK_TYPE_UNSPECIFIED Tidak ditentukan, jangan gunakan.
LINK_TO_DIGITAL_CONTENT_OFFER Penawaran untuk membeli konten digital.

ExternalContentAppCategory

Kategori aplikasi yang diunduh. Lihat https://support.google.com/googleplay/android-developer/answer/9859673 untuk informasi lebih lanjut tentang kategori aplikasi.

Enum
EXTERNAL_CONTENT_APP_CATEGORY_UNSPECIFIED Tidak ditentukan, jangan gunakan.
APP Aplikasi ini diklasifikasikan dalam kategori aplikasi.
GAME Aplikasi diklasifikasikan dalam kategori game.

Metode

createexternaltransaction

 Membuat transaksi eksternal baru.

getexternaltransaction

 Mendapatkan transaksi eksternal yang ada.

refundexternaltransaction

 Mengembalikan seluruh dana atau sebagian dana dari transaksi eksternal yang ada.

Kode error

Operasi resource ini menampilkan kode error HTTP berikut:

Kode error Alasan Deskripsi Resolusi