Method: externaltransactions.createexternaltransaction

Crea una nueva transacción externa.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Es el recurso superior en el que se creará esta transacción externa. Formato: applications/{packageName}

Parámetros de consulta

Parámetros
externalTransactionId

string

Obligatorio. Es el ID que se usará para la transacción externa. Debe ser único entre todas las otras transacciones de la app. Este valor debe tener entre 1 y 63 caracteres, y los caracteres válidos son /a-zA-Z0-9_-/. No se debe usar este campo para almacenar información de identificación personal (PII), como correos electrónicos. Si se intenta almacenar PII en este campo, podrían bloquearse las solicitudes.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de ExternalTransaction.

Cuerpo de la respuesta

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de ExternalTransaction.

Muestra

La siguiente es una solicitud de ejemplo:

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

A continuación, se muestra una respuesta de ejemplo:

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

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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