Method: externaltransactions.refundexternaltransaction

Mevcut harici bir işlemi geri öder veya kısmen geri öder.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Zorunlu. Geri ödenecek harici işlemin adı. Biçim: applications/{packageName}/externalTransactions/{externalTransaction}

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "refundTime": string,

  // Union field refund_type can be only one of the following:
  "partialRefund": {
    object (PartialRefund)
  },
  "fullRefund": {
    object (FullRefund)
  }
  // End of list of possible types for union field refund_type.
}
Alanlar
refundTime

string (Timestamp format)

Zorunlu. İşlemin geri ödemesinin yapıldığı zaman.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
Birlik alanı refund_type. Zorunlu. Harici işlem geri ödemesinin türü. refund_type yalnızca aşağıdakilerden biri olabilir:
partialRefund

object (PartialRefund)

Kısmi geri ödeme.
fullRefund

object (FullRefund)

Tam tutarın geri ödenmesi.

Yanıt gövdesi

Başarılıysa yanıt metni, ExternalTransaction öğesinin bir örneğini içerir.

Örnek

Aşağıda örnek bir istek verilmiştir:

curl \
  -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/externalTransactions/foo:refund' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  -H 'Content-Type: application/json' \
  -d '{ \
    "partialRefund": { \
      "refundId": "my_refund_id", \
      "refundPreTaxAmount": { \
        "currency": "USD", \
        "priceMicros": "10120000" \
      } \
    }, \
    "refundTime": "2023-10-20T16:43:32.852Z" \
  }'

Aşağıda örnek bir yanıt verilmiştir:

{
  "externalTransactionId": "1234567890123456789012345678901234567890123456789012345678901234",
  "originalPreTaxAmount": {
    "currency": "USD",
    "priceMicros": "1990000"
  },
  "originalTaxAmount": {
    "currency": "USD",
    "priceMicros": "11400000"
  },
  "packageName": "com.example.app",
  "transactionState": "TRANSACTION_CANCELED",
  "transactionTime": "2023-04-01T12:00:00Z",
  "userTaxAddress": {
    "regionCode": "US"
  },
  "createTime": "2023-04-01T11:55:00Z",
  "currentPreTaxAmount": {
    "currency": "USD",
    "priceMicros": "0"
  },
  "currentTaxAmount": {
    "currency": "USD",
    "priceMicros": "0"
  },
  "testPurchase": {},
  "recurringTransaction": {
    "initialExternalTransactionId": "9876543210987654321098765432109876543210987654321098765432109876",
    "externalSubscription": {
      "subscriptionType": "RECURRING"
    }
  }
}

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

PartialRefund

Bir işlem için kısmi geri ödeme.

JSON gösterimi 
{
  "refundId": string,
  "refundPreTaxAmount": {
    object (Price)
  }
}
Alanlar
refundId

string

Zorunlu. Bu kısmi geri ödemeyi ayırt eden benzersiz bir kimlik. Geri ödeme başarılı olursa aynı kimliğe sahip sonraki geri ödemeler başarısız olur. Tek bir işlem için geri ödemelerde benzersiz olmalıdır.
refundPreTaxAmount

object (Price)

Zorunlu. Kısmi geri ödemenin vergi öncesi tutarı. İşlemin vergi öncesi kalan tutarından az olmalıdır.

FullRefund

Bu türde alan yoktur.

İşlemin kalan tutarının eksiksiz olarak geri ödenmesi.