REST Resource: externaltransactions

Ressource: ExternalTransaction

Détails d'une transaction externe.

Représentation JSON 
{
  "packageName": string,
  "externalTransactionId": string,
  "originalPreTaxAmount": {
    object (Price)
  },
  "originalTaxAmount": {
    object (Price)
  },
  "currentPreTaxAmount": {
    object (Price)
  },
  "currentTaxAmount": {
    object (Price)
  },
  "testPurchase": {
    object (ExternalTransactionTestPurchase)
  },
  "transactionTime": string,
  "createTime": string,
  "transactionState": enum (TransactionState),
  "userTaxAddress": {
    object (ExternalTransactionAddress)
  },

  // Union field transaction_type can be only one of the following:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of list of possible types for union field transaction_type.
}
Champs
packageName

string

Uniquement en sortie. Nom de ressource de la transaction externe. Nom de package de l'application où les produits intégrés ont été vendus (par exemple, "com.some.app").
externalTransactionId

string

Uniquement en sortie. Identifiant de cette transaction. Tous les ID de transaction sous le même nom de package doivent être uniques. Définissez ce paramètre lors de la création de la transaction externe.
originalPreTaxAmount

object (Price)

Obligatoire. Montant de la transaction d'origine hors taxes. Il s'agit du montant hors taxes initialement notifié à Google avant l'application des remboursements.
originalTaxAmount

object (Price)

Obligatoire. Montant des taxes d'origine. Il s'agit du montant des taxes notifié à Google avant l'application des éventuels remboursements.
currentPreTaxAmount

object (Price)

Uniquement en sortie. Montant actuel de la transaction hors taxes. Il s'agit du montant actuel hors taxes, y compris les éventuels remboursements effectués pour cette transaction.
currentTaxAmount

object (Price)

Uniquement en sortie. Montant actuel des taxes. Il s'agit du montant actuel des taxes, y compris les éventuels remboursements effectués pour cette transaction.
testPurchase

object (ExternalTransactionTestPurchase)

Uniquement en sortie. Si cette option est définie, il s'agit d'un achat test. Google ne facturera pas de transaction test.
transactionTime

string (Timestamp format)

Obligatoire. Heure à laquelle la transaction a été effectuée.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

Uniquement en sortie. Date et heure de création de cette transaction. Il s'agit du moment où Google a été informé de la transaction.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
transactionState

enum (TransactionState)

Uniquement en sortie. État actuel de la transaction.
userTaxAddress

object (ExternalTransactionAddress)

Obligatoire. Adresse de l'utilisateur pour le calcul des taxes.
Champ d'union transaction_type. Type de transaction effectuée. transaction_type ne peut être qu'un des éléments suivants :
oneTimeTransaction

object (OneTimeExternalTransaction)

Il s'agit d'une transaction unique qui ne fait pas partie d'un abonnement.
recurringTransaction

object (RecurringExternalTransaction)

Cette transaction fait partie d'une série récurrente de transactions.

ExternalTransactionTestPurchase

Ce type ne comporte aucun champ.

Représente une transaction effectuée à l'aide d'un compte de test. Ces transactions ne seront pas facturées par Google.

OneTimeExternalTransaction

Représente une transaction unique.

Représentation JSON 
{
  "externalTransactionToken": string
}
Champs
externalTransactionToken

string

Uniquement en entrée. Fourni lors de l'appel de Create. Ces informations sont récupérées auprès du client lors du lancement du flux de facturation alternatif.

RecurringExternalTransaction

Représente une transaction faisant partie d'une série de paiements récurrents. Il peut s'agir d'un abonnement ou d'un produit ponctuel nécessitant plusieurs paiements (précommande, par exemple).

Représentation JSON 
{

  // Union field source can be only one of the following:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of list of possible types for union field source.

  // Union field product_details can be only one of the following:
  "externalSubscription": {
    object (ExternalSubscription)
  }
  // End of list of possible types for union field product_details.
}
Champs

Champ d'union source.

source ne peut être qu'un des éléments suivants :
initialExternalTransactionId

string

Identifiant externe de la première transaction de cette série récurrente de transactions. Par exemple, pour un abonnement, il s'agit de l'ID de transaction du premier paiement. Obligatoire lors de la création de transactions externes récurrentes.
externalTransactionToken

string

Uniquement en entrée. Fourni lors de l'appel de Create. Ces informations sont récupérées auprès du client lors du lancement du flux de facturation alternatif. Obligatoire uniquement pour l'achat initial.
migratedTransactionProgram

enum (ExternalTransactionProgram)

Uniquement en entrée. Fourni lors de l'appel de Create. À utiliser uniquement lors du passage d'un reporting mensuel manuel à un reporting automatisé.
Champ d'union product_details. Obligatoire. Détails du produit inclus dans la transaction externe récurrente product_details ne peut être qu'un des éléments suivants :
externalSubscription

object (ExternalSubscription)

Détails d'un abonnement externe

ExternalTransactionProgram

Représente le programme de transaction externe rencontré par l'utilisateur pour effectuer la transaction.

Enums
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Programme de transaction non spécifié. Non utilisé.
USER_CHOICE_BILLING La facturation au choix de l'utilisateur, qui peut choisir entre la facturation Google Play Billing gérée par le développeur.
ALTERNATIVE_BILLING_ONLY Système de facturation alternatif uniquement, où les utilisateurs ne peuvent utiliser que la facturation administrateur pour les développeurs.

ExternalSubscription

Détails d'un abonnement externe

Représentation JSON 
{
  "subscriptionType": enum (SubscriptionType)
}
Champs
subscriptionType

enum (SubscriptionType)

Obligatoire. Type d'abonnement externe.

SubscriptionType

Types d'abonnements externes.

Enums
SUBSCRIPTION_TYPE_UNSPECIFIED Non spécifié, ne pas utiliser.
RECURRING Il s'agit d'un abonnement récurrent où l'utilisateur est facturé à chaque cycle de facturation.
PREPAID Il s'agit d'un abonnement prépayé pour lequel l'utilisateur paie à l'avance.

TransactionState

État d'une transaction en cours d'exécution.

Enums
TRANSACTION_STATE_UNSPECIFIED État de la transaction non spécifié. Non utilisé.
TRANSACTION_REPORTED La transaction a bien été signalée à Google.
TRANSACTION_CANCELED La transaction a été intégralement remboursée.

ExternalTransactionAddress

Adresse de l'utilisateur pour la transaction externe.

Représentation JSON 
{
  "regionCode": string,
  "administrativeArea": string
}
Champs
regionCode

string

Obligatoire. Code régional à deux lettres basé sur la norme ISO-3166-1 Alpha-2 (codes régionaux des Nations Unies).
administrativeArea

string

Facultatif. Subdivision administrative de niveau supérieur du pays/de la région. Obligatoire uniquement pour les transactions en Inde. "PÉRAGNAMIQUE"""ANDA-HIÉRAMY", "PADALO-HAUT-HIÉRARGE", "PADAMANCHE-BAUCHER", "PADALO-HAUT-HIÉRARÎNE", "PADAMANH

Méthodes

createexternaltransaction

 Crée une transaction externe.

getexternaltransaction

 Récupère une transaction externe existante.

refundexternaltransaction

 Rembourse ou rembourse partiellement une transaction externe existante.