Method: externaltransactions.refundexternaltransaction

Erstattet eine vorhandene externe Transaktion vollständig oder teilweise.

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.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. 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 Erstattung des vollen Betrags.

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 Teilerstattung kennzeichnet. Wenn die Erstattung erfolgreich ist, 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. Sollte niedriger sein als der verbleibende Betrag der Transaktion vor Steuern.

FullRefund

Dieser Typ hat keine Felder.

Eine vollständige Erstattung des verbleibenden Betrags einer Transaktion.