Method: externaltransactions.createexternaltransaction

• Permintaan HTTP
• Parameter lokasi
• Parameter kueri
• Isi permintaan
• Isi respons
• Cakupan otorisasi
• Cobalah!

Membuat transaksi eksternal baru.

Permintaan HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/{parent=applications/*}/externalTransactions

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent	string Wajib. Resource induk tempat transaksi eksternal ini akan dibuat. Format: applications/{packageName}

Parameter kueri

Parameter
externalTransactionId	string Wajib. ID yang digunakan untuk transaksi eksternal. Harus unik di semua transaksi lain untuk aplikasi ini. Nilai ini harus terdiri dari 1-63 karakter dan karakter yang valid adalah /a-zA-Z0-9_-/. Jangan gunakan kolom ini untuk menyimpan Informasi Identitas Pribadi (PII) seperti email. Mencoba menyimpan PII di kolom ini dapat mengakibatkan permintaan diblokir.

Isi permintaan

Isi permintaan memuat instance ExternalTransaction.

Isi respons

Jika berhasil, isi respons memuat instance ExternalTransaction yang baru dibuat.

Contoh

Berikut adalah contoh permintaan:

curl \
  -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/externalTransactions?externalTransactionId=exampleExternalTransactionId' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  -H 'Content-Type: application/json' \
  -d '{ \
    "originalPreTaxAmount": { \
      "currency": "USD", \
      "priceMicros": "1000000" \
    }, \
    "originalTaxAmount": { \
      "currency": "USD", \
      "priceMicros": "100000" \
    }, \
    "transactionTime": "2023-05-05T12:00:00Z", \
    "oneTimeTransaction": { \
      "externalTransactionToken": "token-123" \
    }, \
    "userTaxAddress": { \
      "regionCode": "US" \
    } \
  }'

Berikut adalah contoh respons:

{
  "createTime": "2023-04-20T14:23:18.121Z",
  "currentPreTaxAmount": {
    "currency": "USD",
    "priceMicros": "12000000"
  },
  "currentTaxAmount": {
    "currency": "USD",
    "priceMicros": "1200000"
  },
  "externalTransactionId": "ext-trans-id-1234",
  "oneTimeTransaction": {
    "externalTransactionToken": "one-time-token-abc"
  },
  "originalPreTaxAmount": {
    "currency": "USD",
    "priceMicros": "15000000"
  },
  "originalTaxAmount": {
    "currency": "USD",
    "priceMicros": "1500000"
  },
  "packageName": "com.example.app",
  "recurringTransaction": {
    "externalSubscription": {
      "subscriptionType": "RECURRING"
    },
    "externalTransactionToken": "recurring-token-xyz",
    "initialExternalTransactionId": "ext-trans-id-5678",
    "otherRecurringProduct": {}
  },
  "testPurchase": {},
  "transactionProgramCode": 11,
  "transactionState": "TRANSACTION_REPORTED",
  "transactionTime": "2023-04-20T14:20:00.000Z",
  "userTaxAddress": {
    "regionCode": "US"
  }
}

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

• https://www.googleapis.com/auth/androidpublisher