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)
  },

  // 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. Jumlah transaksi awal sebelum pajak. Ini adalah jumlah sebelum pajak yang awalnya dilaporkan kepada Google sebelum pengembalian dana apa pun diterapkan.

originalTaxAmount

object (Price)

Wajib. Jumlah pajak awal. Nilai ini menunjukkan jumlah pajak yang awalnya dilaporkan 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 apa pun yang mungkin telah diterapkan untuk 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 adalah pembelian percobaan. Google tidak akan menagih biaya untuk transaksi percobaan.

transactionTime

string (Timestamp format)

Wajib. Waktu saat transaksi selesai.

Stempel waktu dalam format 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 ketika Google menerima pemberitahuan tentang transaksi.

Stempel waktu dalam format 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. Alamat pengguna untuk penghitungan pajak.

Kolom union transaction_type. Jenis transaksi yang dilakukan. transaction_type hanya ada berupa salah satu diantara berikut:
oneTimeTransaction

object (OneTimeExternalTransaction)

Transaksi ini hanya dilakukan satu kali dan bukan bagian dari langganan.

recurringTransaction

object (RecurringExternalTransaction)

Transaksi ini adalah bagian dari rangkaian transaksi berulang.

ExternalTransactionTestPurchase

Jenis ini tidak memiliki kolom.

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

OneTimeExternalTransaction

Mewakili transaksi satu kali.

Representasi JSON
{
  "externalTransactionToken": string
}
Kolom
externalTransactionToken

string

Hanya input. Disediakan selama panggilan untuk Create. Diambil dari klien saat alur penagihan alternatif diluncurkan.

RecurringExternalTransaction

Mewakili transaksi yang merupakan bagian dari rangkaian 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)
  }
  // End of list of possible types for union field product_details.
}
Kolom

Kolom union source.

source hanya dapat berupa salah satu dari berikut:

initialExternalTransactionId

string

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

externalTransactionToken

string

Hanya input. Disediakan selama panggilan untuk Create. Diambil dari klien saat alur penagihan alternatif diluncurkan. Diperlukan hanya untuk pembelian awal.

migratedTransactionProgram

enum (ExternalTransactionProgram)

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

Kolom union product_details. Wajib. Detail produk dalam transaksi eksternal berulang. product_details hanya ada berupa salah satu diantara berikut:
externalSubscription

object (ExternalSubscription)

Detail langganan eksternal.

ExternalTransactionProgram

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

Enum
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Program transaksi tidak ditentukan. Tidak digunakan.
USER_CHOICE_BILLING Penagihan sesuai pilihan pengguna, yang memungkinkan pengguna memilih antara penagihan yang dikelola developer Layanan Penagihan Google Play.
ALTERTNATIVE_BILLING_ONLY Atau khusus penagihan, yang pengguna hanya dapat menggunakan penagihan pengelola developer.

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 Belum ditentukan, jangan digunakan.
RECURRING Ini adalah langganan berulang yang mengharuskan pengguna ditagih setiap siklus penagihan.
PREPAID Ini adalah langganan prabayar yang memungkinkan pengguna membayar di muka.

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 Dana transaksi telah dikembalikan 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 teratas negara/wilayah. Hanya diwajibkan untuk transaksi di India. Nilai yang valid adalah "ANDAMAN AND NIDAYA PRADESH", "ANDHRA PRADESH", "ARUNMISHAL PRADESH", "ASSAMAMAN", "BIHAR, "CHANDIGARH", "CHHATTISGARH", "DADRA AND NAGAR HAVELIVELI", "DADRA AND NAGAR HAVEHILIANGAN","

Metode

createexternaltransaction

Membuat transaksi eksternal baru.

getexternaltransaction

Mendapatkan transaksi eksternal yang sudah ada.

refundexternaltransaction

Mengembalikan dana atau mengembalikan sebagian dana untuk transaksi eksternal yang sudah ada.