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,
  "externalOfferInitialAcquisitionDetails": {
    object (ExternalOfferInitialAcquisitionDetails)
  },

  // 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 pendant laquelle 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 un même nom de package doivent être uniques. Défini 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 indiqué à Google avant l'application des éventuels remboursements.

originalTaxAmount

object (Price)

Obligatoire. Montant des taxes d'origine Il s'agit du montant des taxes initialement 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 qui ont pu être appliqués à 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 qui ont pu être appliqués à cette transaction.

testPurchase

object (ExternalTransactionTestPurchase)

Uniquement en sortie. S'il est défini, il s'agit d'un achat test. Google ne facturera pas les transactions test.

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. Date et heure de création de cette transaction. Il s'agit de la date à 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 pour les applications éligibles participant aux programmes Partenaires. Les développeurs qui participent au programme Play Media Experience (https://play.google.com/console/about/programs/mediaprogram/) doivent fournir le code du programme lorsqu'ils signalent des transactions de système de facturation alternatif. Si vous êtes un développeur éligible, veuillez contacter votre responsable du développement commercial pour en savoir plus sur la configuration de ce champ. Remarque: Ce champ ne peut pas être utilisé pour les transactions liées aux offres externes.

externalOfferInitialAcquisitionDetails

object (ExternalOfferInitialAcquisitionDetails)

Facultatif. Détails concernant la première transaction effectuée par un utilisateur ou un appareil à l'aide d'offres externes. Non obligatoire pour les transactions effectuées avec la facturation au choix de l'utilisateur ou un système de facturation alternatif uniquement.

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 à Create. Elle est récupérée à partir du client lors du lancement du flux de facturation alternatif.

RecurringExternalTransaction

Représente une transaction faisant partie d'une série récurrente de paiements. Il peut s'agir d'un abonnement ou d'un produit ponctuel avec plusieurs paiements (une 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)
  },
  "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

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 à Create. Elle est récupérée à partir 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 à Create. Ne doit être utilisée que lors de la migration d'un abonnement des rapports mensuels manuels vers des rapports automatiques.

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)

Détails d'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 finaliser 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 lui permet de 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 développeur-administrateur.

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'abonnement externe.

Enums
SUBSCRIPTION_TYPE_UNSPECIFIED Non spécifié, ne pas utiliser.
RECURRING Il s'agit d'un abonnement récurrent pour lequel l'utilisateur est facturé à chaque cycle de facturation.
PREPAID Il s'agit d'un abonnement prépayé pour lequel 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é enregistrée auprès de 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 de région de l'ONU).

administrativeArea

string

Facultatif. Subdivision administrative de niveau supérieur du pays/de la région. Obligatoire uniquement pour les transactions en Inde.

ExternalOfferInitialAcquisitionDetails

Détails concernant la première transaction effectuée par un utilisateur ou un appareil à l'aide d'offres externes.

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

string

Obligatoire. ID de la transaction externe du premier achat effectué par l'utilisateur.

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.