REST Resource: externaltransactions

Referensi: 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,
  "externalOfferInitialAcquisitionDetails": {
    object (ExternalOfferInitialAcquisitionDetails)
  },

  // 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.
}
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 dengan nama paket yang sama harus unik. Tetapkan saat membuat transaksi eksternal.

originalPreTaxAmount

object (Price)

Wajib diisi. Jumlah transaksi asli sebelum pajak. Ini menunjukkan jumlah sebelum pajak yang awalnya diberitahukan kepada Google sebelum pengembalian dana apa pun diterapkan.

originalTaxAmount

object (Price)

Wajib diisi. Jumlah pajak awal. Ini menunjukkan jumlah pajak yang awalnya diberitahukan kepada Google sebelum pengembalian dana apa pun diterapkan.

currentPreTaxAmount

object (Price)

Hanya output. Jumlah transaksi saat ini sebelum pajak. Ini menunjukkan jumlah sebelum pajak saat ini termasuk pengembalian dana yang mungkin telah diterapkan ke transaksi ini.

currentTaxAmount

object (Price)

Hanya output. Jumlah pajak saat ini. Ini menunjukkan jumlah pajak saat ini termasuk pengembalian dana yang mungkin telah diterapkan pada transaksi ini.

testPurchase

object (ExternalTransactionTestPurchase)

Hanya output. Jika ditetapkan, transaksi ini merupakan pembelian percobaan. Google tidak akan mengenakan biaya atas transaksi percobaan.

transactionTime

string (Timestamp format)

Wajib diisi. Waktu saat transaksi selesai.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

createTime

string (Timestamp format)

Hanya output. Waktu saat transaksi ini dibuat. Ini adalah waktu saat Google menerima pemberitahuan tentang transaksi tersebut.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

transactionState

enum (TransactionState)

Hanya output. Status transaksi saat ini.

userTaxAddress

object (ExternalTransactionAddress)

Wajib diisi. Alamat pengguna untuk komputasi pajak.

transactionProgramCode

integer

Opsional. Kode program transaksi, yang digunakan untuk membantu menentukan tarif layanan untuk aplikasi yang memenuhi syarat yang berpartisipasi dalam program partner. Developer yang berpartisipasi dalam Program Pengalaman Media Google Play (https://play.google.com/console/about/programs/mediaprogram/) harus memberikan kode program saat melaporkan transaksi penagihan alternatif. Jika Anda adalah developer yang memenuhi syarat, hubungi BDM untuk mengetahui informasi selengkapnya tentang cara menetapkan kolom ini. Catatan: kolom ini tidak dapat digunakan untuk transaksi penawaran eksternal.

externalOfferInitialAcquisitionDetails

object (ExternalOfferInitialAcquisitionDetails)

Opsional. Detail tentang kali pertama pengguna/perangkat menyelesaikan transaksi menggunakan penawaran eksternal. Tidak diwajibkan untuk transaksi yang dilakukan menggunakan penagihan sesuai pilihan pengguna atau penagihan alternatif saja.

Kolom union transaction_type. Jenis transaksi yang dilakukan. transaction_type hanya dapat berupa salah satu dari berikut:
oneTimeTransaction

object (OneTimeExternalTransaction)

Transaksi ini adalah transaksi satu kali, bukan bagian dari langganan.

recurringTransaction

object (RecurringExternalTransaction)

Transaksi ini adalah bagian dari rangkaian transaksi berulang.

ExternalTransactionTestPurchase

Jenis ini tidak memiliki kolom.

Merepresentasikan transaksi yang dilakukan menggunakan akun pengujian. Transaksi ini tidak akan ditagih oleh Google.

OneTimeExternalTransaction

Menunjukkan transaksi satu kali.

Representasi JSON
{
  "externalTransactionToken": string
}
Kolom
externalTransactionToken

string

Input saja. Disediakan selama panggilan ke Create. Diambil dari klien saat alur penagihan alternatif diluncurkan.

RecurringExternalTransaction

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

Representasi 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.
}
Kolom

Kolom union source.

source hanya dapat berupa salah satu dari yang berikut:

initialExternalTransactionId

string

ID transaksi eksternal dari transaksi pertama dari rangkaian transaksi berulang ini. Misalnya, untuk langganan, ini adalah ID transaksi dari pembayaran pertama. Wajib saat membuat transaksi eksternal berulang.

externalTransactionToken

string

Input saja. Disediakan selama panggilan ke Create. Diambil dari klien saat alur penagihan alternatif diluncurkan. Diperlukan hanya untuk pembelian awal.

migratedTransactionProgram

enum (ExternalTransactionProgram)

Input saja. Disediakan selama panggilan ke Create. Hanya boleh digunakan saat memigrasikan langganan dari pelaporan bulanan manual ke pelaporan otomatis.

Kolom union product_details. Wajib diisi. Detail produk dalam transaksi eksternal berulang. product_details hanya dapat berupa salah satu dari berikut:
externalSubscription

object (ExternalSubscription)

Detail langganan eksternal.

otherRecurringProduct

object (OtherRecurringProduct)

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

ExternalTransactionProgram

Menampilkan program transaksi eksternal yang dialami oleh pengguna untuk menyelesaikan transaksi.

Enum
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Program transaksi belum ditetapkan. Tidak digunakan.
USER_CHOICE_BILLING Penagihan sesuai pilihan pengguna, yang memungkinkan pengguna memilih antara penagihan yang dikelola developer Layanan Penagihan Google Play.
ALTERNATIVE_BILLING_ONLY Khusus penagihan alternatif, dengan pengguna hanya dapat menggunakan penagihan pengelola developer.

ExternalSubscription

Detail langganan eksternal.

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

enum (SubscriptionType)

Wajib diisi. Jenis langganan eksternal.

SubscriptionType

Jenis langganan eksternal.

Enum
SUBSCRIPTION_TYPE_UNSPECIFIED Belum ditentukan, jangan digunakan.
RECURRING Ini adalah langganan berulang dengan pengguna ditagih setiap siklus penagihan.
PREPAID Ini adalah langganan prabayar yang mengharuskan pengguna membayar di muka.

OtherRecurringProduct

Jenis ini tidak memiliki kolom.

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

TransactionState

Status transaksi yang dilakukan.

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

ExternalTransactionAddress

Alamat pengguna untuk transaksi eksternal.

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

string

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

administrativeArea

string

Opsional. Subdivisi administratif tingkat teratas di negara/wilayah. Hanya diwajibkan untuk transaksi di India.

ExternalOfferInitialAcquisitionDetails

Detail tentang kali pertama pengguna/perangkat menyelesaikan transaksi menggunakan penawaran eksternal.

Representasi JSON
{
  "externalTransactionId": string
}
Kolom
externalTransactionId

string

Wajib diisi. ID transaksi eksternal dari pembelian pertama yang diselesaikan yang dilakukan oleh pengguna.

Metode

createexternaltransaction

Membuat transaksi eksternal baru.

getexternaltransaction

Mendapatkan transaksi eksternal yang ada.

refundexternaltransaction

Mengembalikan dana atau mengembalikan sebagian dana transaksi eksternal yang ada.