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)
  },
  "transactionProgramCode": integer,

  // 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 la ressource de la transaction externe. Nom de package de l'application dans laquelle les produits intégrés ont été vendus (par exemple, "com.some.app").
externalTransactionId

string

Uniquement en sortie. ID de cette transaction. Tous les ID de transaction associés au même nom de package doivent être uniques. Défini lors de la création de la transaction externe.
originalPreTaxAmount

object (Price)

Obligatoire. Montant d'origine de la transaction avant taxes. Il s'agit du montant hors taxes initialement communiqué à Google avant tout remboursement.
originalTaxAmount

object (Price)

Obligatoire. Montant des taxes d'origine. Il s'agit du montant des taxes initialement communiqué à Google avant tout remboursement.
currentPreTaxAmount

object (Price)

Uniquement en sortie. Montant actuel de la transaction hors taxes. Il s'agit du montant actuel avant taxes, y compris les remboursements qui ont pu être appliqués à cette transaction.
currentTaxAmount

object (Price)

Uniquement en sortie. Montant actuel de la taxe. Il s'agit du montant actuel des taxes, y compris les remboursements qui ont pu être appliqués à cette transaction.
testPurchase

object (ExternalTransactionTestPurchase)

Uniquement en sortie. Si cette valeur est définie, cette transaction était un achat test. Google ne facture pas les transactions tests.
transactionTime

string (Timestamp format)

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

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

Uniquement en sortie. Heure de création de cette transaction. Heure à laquelle Google a été informé de la transaction.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. 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.
transactionProgramCode

integer

Facultatif. Code du programme de transaction, utilisé pour déterminer les frais de service des applications éligibles participant aux programmes partenaires. Les développeurs participant au programme Play Media Experience (https://play.google.com/console/about/programs/mediaprogram/) doivent fournir le code du programme lorsqu'ils enregistrent des transactions via un système de facturation alternatif. Si vous êtes un développeur éligible, veuillez contacter votre BDM pour savoir comment définir ce champ. Remarque: Ce champ ne peut pas être utilisé pour les transactions d'offres externes.
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 et non d'un abonnement.
recurringTransaction

object (RecurringExternalTransaction)

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

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 création. Récupéré auprès du client lorsque le parcours de facturation alternatif est lancé.

RecurringExternalTransaction

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

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)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // 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

ID de transaction externe de la première transaction de cette série de transactions récurrentes. 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 création. Récupéré auprès du client lorsque le parcours de facturation alternatif est lancé. Obligatoire uniquement pour l'achat initial.
migratedTransactionProgram

enum (ExternalTransactionProgram)

Uniquement en entrée. Fourni lors de l'appel de création. Ne doit être utilisé que lors de la migration d'un abonnement de la création manuelle de rapports mensuels vers la création automatique de rapports.
Champ d'union product_details. Obligatoire. Détails du produit 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.
otherRecurringProduct

object (OtherRecurringProduct)

Informations sur un produit de transaction externe récurrent qui n'appartient à aucune autre catégorie spécifique.

ExternalTransactionProgram

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

Enums
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Programme de transaction non spécifié. Non utilisé.
USER_CHOICE_BILLING Facturation au choix de l'utilisateur, qui permet à l'utilisateur de choisir entre Google Play Billing et la facturation 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 du développeur-gestionnaire.

ExternalSubscription

Détails d'un abonnement externe.

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

enum (SubscriptionType)

Obligatoire. Type de l'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 qui est facturé à l'utilisateur à chaque cycle de facturation.
PREPAID Il s'agit d'un abonnement prépayé que l'utilisateur paie à l'avance.

OtherRecurringProduct

Ce type ne comporte aucun champ.

Détails d'un produit de transaction externe récurrent qui n'appartient à aucune autre catégorie plus spécifique.

TransactionState

État d'une transaction en cours.

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 de région à deux lettres basé sur la norme ISO 3166-1 alpha-2 (codes de région de l'ONU).
administrativeArea

string

Facultatif. Subdivision administrative de niveau supérieur du pays/de la région. Uniquement requis pour les transactions en Inde. Les valeurs valides sont "ANDAMAN AND NICOBAR ISLANDS", "ANDHRA PRADESH", "ARUNACHAL PRADESH", "ASSAM", "BIHAR", "CHANDIGARH", "CHHATTISGARH", "DADRA AND NAGAR HAVELI", "DADRA AND NAGAR HAVELI AND DAMAN AND DIU", "DAMAN AND DIU", "DELHI", "GOA", "GUJARAT", "HARYANA", "HIMACHAL PRADESH", "JAMMU AND KASHMIR", "JHARKHAND", "KARNATAKA", "KERALA", "LADAKH", "LAKSHADWEEP", "MADHYA PRADESH", "MAHARASHTRA", "MANIPUR", "MEGHALAYA", "MIZORAM", "NAGALAND", "ODISHA", "PUDUCHERRY", "PUNJAB", "RAJASTHAN", "SIKKIM", "TAMIL NADU", "TELANGANA", "TRIPURA", "UTTAR PRADESH", "UTTARAKHAND" et "WEST BENGAL".

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.