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. Setel 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 diterapkan.
originalTaxAmount

object (Price)

Wajib. Jumlah pajak awal. Ini merupakan jumlah pajak yang awalnya diberitahukan 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 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. Ini adalah 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 untuk 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 developer yang memenuhi syarat, hubungi BDM Anda untuk mengetahui informasi selengkapnya tentang cara menyetel 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 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

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 seluruh dana atau sebagian dana dari transaksi eksternal yang ada.

Kode error

Operasi resource ini menampilkan kode error HTTP berikut:

Kode error Alasan Resolusi
5xx Error umum di server Google Play. Coba lagi permintaan Anda.

Jika masalah berlanjut, hubungi pengelola akun Google Play Anda atau kirimkan permintaan dukungan. Pertimbangkan untuk memeriksa Dasbor Status Play untuk mengetahui pemadaman layanan yang diketahui.
409 Error pembaruan serentak.

Ada upaya untuk memperbarui objek yang sedang diperbarui. Misalnya, pembelian dikonfirmasi dengan memanggil metode acknowledgePurchase() Play Billing Library dan dengan memanggil purchases.products.acknowledge Play Developer API secara bersamaan.

 Coba lagi permintaan Anda.