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,

  // 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 merupakan jumlah sebelum pajak yang awalnya diberi tahu kepada Google sebelum pengembalian dana diterapkan.
originalTaxAmount

object (Price)

Wajib. Jumlah pajak awal. Ini merupakan jumlah pajak yang awalnya diberi tahu kepada Google sebelum pengembalian dana diterapkan.
currentPreTaxAmount

object (Price)

Hanya output. Jumlah transaksi saat ini sebelum pajak. Ini 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. 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 saat transaksi diselesaikan.

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 diberi tahu tentang transaksi ini.

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.
transactionProgramCode

integer

Opsional. Kode program transaksi, yang digunakan untuk membantu menentukan biaya layanan untuk aplikasi yang memenuhi syarat dan 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 Anda untuk mengetahui informasi selengkapnya tentang cara menetapkan kolom ini. Catatan: kolom ini tidak dapat digunakan untuk transaksi penawaran eksternal.
Kolom union transaction_type. Jenis transaksi yang dilakukan. transaction_type hanya dapat berupa salah satu dari berikut:
oneTimeTransaction

object (OneTimeExternalTransaction)

Ini adalah transaksi satu kali dan bukan bagian dari langganan.
recurringTransaction

object (RecurringExternalTransaction)

Transaksi ini adalah bagian dari rangkaian transaksi yang berulang.

ExternalTransactionTestPurchase

Jenis ini tidak memiliki kolom.

Merupakan 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. Diberikan selama panggilan untuk Membuat. Diambil dari klien saat alur penagihan alternatif diluncurkan.

RecurringExternalTransaction

Merupakan transaksi yang merupakan bagian dari rangkaian pembayaran berulang. 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 hal berikut:
initialExternalTransactionId

string

ID transaksi eksternal dari transaksi pertama dari rangkaian transaksi berulang ini. Misalnya, untuk langganan, ini adalah ID transaksi 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. Diperlukan hanya 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.
Kolom union product_details. Wajib. 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

Merupakan 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, ketika pengguna dapat memilih antara Layanan Penagihan Google Play atau penagihan yang dikelola developer.
ALTERNATIVE_BILLING_ONLY Hanya penagihan alternatif, ketika pengguna hanya boleh menggunakan penagihan yang dikelola 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 Tidak ditentukan, jangan gunakan.
RECURRING Ini adalah langganan berulang ketika pengguna ditagih setiap siklus penagihan.
PREPAID Ini adalah langganan prabayar ketika 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 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".

Metode

createexternaltransaction

 Membuat transaksi eksternal baru.

getexternaltransaction

 Mendapatkan transaksi eksternal yang ada.

refundexternaltransaction

 Mengembalikan dana sepenuhnya atau sebagian untuk transaksi eksternal yang ada.