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

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

object (Price)

Wajib. Jumlah transaksi awal sebelum pajak. Ini merupakan jumlah sebelum pajak yang awalnya diberitahukan kepada Google sebelum pengembalian dana apa pun diterapkan.
originalTaxAmount

object (Price)

Wajib. Jumlah pajak awal. Ini merupakan 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 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 untuk transaksi ini.
testPurchase

object (ExternalTransactionTestPurchase)

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

string (Timestamp format)

Wajib. Waktu saat transaksi selesai.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. 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 diberi tahu tentang transaksi tersebut.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. 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 dikenai biaya oleh Google.

OneTimeExternalTransaction

Mewakili transaksi satu kali.

Representasi JSON 
{
  "externalTransactionToken": string
}
Kolom
externalTransactionToken

string

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

RecurringExternalTransaction

Mewakili transaksi yang merupakan bagian dari rangkaian pembayaran berulang. Produk ini bisa 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 akan menjadi ID transaksi pembayaran pertama. Diperlukan saat membuat transaksi eksternal berulang.
externalTransactionToken

string

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

enum (ExternalTransactionProgram)

Hanya input. Disediakan selama panggilan untuk Membuat. 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.
otherRecurringProduct

object (OtherRecurringProduct)

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

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 dapat memilih antara penagihan yang dikelola developer Layanan Penagihan Google Play.
ALTERNATIVE_BILLING_ONLY Khusus penagihan alternatif, ketika pengguna hanya dapat menggunakan penagihan yang dikelola developer.

ExternalSubscription

Detail langganan eksternal.

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

enum (SubscriptionType)

Wajib. Jenis langganan eksternal.

SubscriptionType

Jenis-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 mengharuskan 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 belum ditetapkan. Tidak digunakan.
TRANSACTION_REPORTED Transaksi 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 DAN NICOBAR ISLANDARAD", "ANDHRA PRADESH", "ARUNACHAL PRADESH", "ASSAMABUH", "BIHARAMA", "CHANDIGARH", "CHHATTISGARH", "DADRA AND NAGAR HAVELI, "DADRA DAN NAGAR HAVELI

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.