Method: externaltransactions.refundexternaltransaction

Eine vorhandene externe Transaktion wird erstattet oder teilweise erstattet.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Name der externen Transaktion, die erstattet wird. Format: applications/{packageName}/externalTransactions/{externalTransaction}

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "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.
}
Felder
refundTime

string (Timestamp format)

Erforderlich. Der Zeitpunkt, zu dem die Transaktion erstattet wurde.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
Union-Feld refund_type. Erforderlich. Art der Erstattung für externe Transaktionen. Für refund_type ist nur einer der folgenden Werte zulässig:
partialRefund

object (PartialRefund)

Eine teilweise Erstattung.
fullRefund

object (FullRefund)

eine volle Erstattung.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von ExternalTransaction.

Beispiel

Hier ein Beispiel für eine Anfrage:

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" \
  }'

Hier ist eine Beispielantwort:

{
  "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"
    }
  }
}

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

PartialRefund

Eine teilweise Erstattung einer Transaktion.

JSON-Darstellung 
{
  "refundId": string,
  "refundPreTaxAmount": {
    object (Price)
  }
}
Felder
refundId

string

Erforderlich. Eine eindeutige ID, die diese teilweise Erstattung kennzeichnet. Wenn die Erstattung erfolgreich war, schlagen nachfolgende Erstattungen mit derselben ID fehl. Muss für Erstattungen für eine einzelne Transaktion eindeutig sein.
refundPreTaxAmount

object (Price)

Erforderlich. Der Betrag der teilweisen Erstattung vor Steuern. Muss kleiner als der verbleibende Betrag der Transaktion vor Steuern sein.

FullRefund

Dieser Typ hat keine Felder.

Eine vollständige Erstattung des verbleibenden Betrags einer Transaktion.