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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "externalOfferDetails": {
    object (ExternalOfferDetails)
  },
  "externalContentLinkDetails": {
    object (ExternalContentLinkDetails)
  }
  // End of mutually exclusive fields.
}
Champs
packageName

string

Uniquement en sortie. Nom de ressource de la transaction externe. Nom du package de l'application dans 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 associés à 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 initial de la transaction avant taxes. Il s'agit du montant hors taxes initialement indiqué à Google avant l'application des remboursements.
originalTaxAmount

object (Price)

Obligatoire. Montant des taxes d'origine. Il s'agit du montant de la taxe initialement indiqué à Google avant l'application des remboursements.
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 des taxes. 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, cela signifie que la transaction était un achat test. Google ne facture pas les transactions de test.
transactionTime

string (Timestamp format)

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

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
createTime

string (Timestamp format)

Uniquement en sortie. L'heure à laquelle cette transaction a été créée. Il s'agit de l'heure à laquelle Google a été informé de la transaction.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
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 à des 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 lors de la déclaration des transactions de système de facturation alternatif. Si vous êtes un développeur éligible, veuillez contacter votre responsable du développement commercial pour plus d'informations sur la façon de renseigner ce champ. Remarque : Ce champ ne peut pas être utilisé pour les transactions d'offres externes.
Le type de transaction effectuée. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
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.
Fin des champs qui s'excluent mutuellement.
Informations spécifiques au programme nécessaires pour les rapports sur les transactions. Les détails ne doivent être définis que pour le programme auquel la transaction est associée. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
externalOfferDetails

object (ExternalOfferDetails)

Facultatif. Informations nécessaires pour rendre compte avec précision des transactions d'offres externes.
externalContentLinkDetails

object (ExternalContentLinkDetails)

Facultatif. Informations nécessaires pour déclarer précisément les transactions liées aux liens vers des contenus externes.
Fin des champs qui s'excluent mutuellement.

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 ponctuelle.

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

string

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

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 (comme une précommande).

Représentation JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of mutually exclusive fields.
}
Champs
Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
initialExternalTransactionId

string

L'identifiant de transaction externe de la première transaction de cette série de transactions récurrentes. Par exemple, pour un abonnement, il s'agirait de l'identifiant de la transaction du premier paiement. Requis lors de la création de transactions externes récurrentes.
externalTransactionToken

string

Uniquement en entrée. Fourni lors de l'appel à Create. Récupéré auprès du client lors du lancement du flux de facturation alternatif. Requis uniquement pour l'achat initial.
migratedTransactionProgram

enum (ExternalTransactionProgram)

Uniquement en entrée. Fourni lors de l'appel à Create. Ne doit être utilisé que lors de la migration d'un abonnement de la création manuelle de rapports mensuels à la création automatique de rapports.
Fin des champs qui s'excluent mutuellement.
Obligatoire. Détails du produit dans la transaction externe récurrente. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
externalSubscription

object (ExternalSubscription)

Détails d'un abonnement externe.
otherRecurringProduct

object (OtherRecurringProduct)

Détails d'un produit de transaction externe récurrente qui n'appartient à aucune autre catégorie spécifique.
Fin des champs qui s'excluent mutuellement.

ExternalTransactionProgram

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

Enums
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Programme de transactions non spécifié. Non utilisé.
USER_CHOICE_BILLING La facturation au choix de l'utilisateur, qui permet à un 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 développeur-gestionnaire.

ExternalSubscription

Détails d'un abonnement externe.

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

enum (SubscriptionType)

Obligatoire. Le 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 où l'utilisateur est facturé à chaque cycle de facturation.
PREPAID Il s'agit d'un abonnement prépayé où 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. Sous-division 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".

ExternalOfferDetails

Détails spécifiques au programme d'offres externes

Représentation JSON 
{
  "linkType": enum (ExternalOfferLinkType),
  "installedAppPackage": string,
  "installedAppCategory": enum (ExternalOfferAppCategory),
  "appDownloadEventExternalTransactionId": string
}
Champs
installedAppPackage

string

Facultatif. Nom du package de l'application téléchargée lors de cette transaction. Obligatoire lorsque linkType est défini sur LINK_TO_APP_DOWNLOAD.
installedAppCategory

enum (ExternalOfferAppCategory)

Facultatif. Catégorie de l'application téléchargée lors de cette transaction. Elle doit correspondre à la catégorie indiquée dans la Play Console lors de la procédure de validation de l'application externe. Obligatoire uniquement pour les téléchargements d'applications.
appDownloadEventExternalTransactionId

string

Facultatif. L'identifiant de transaction externe associé à l'événement de téléchargement d'application via un lien externe. Obligatoire pour signaler les transactions effectuées dans des applications installées en externe.

ExternalOfferLinkType

Type de lien externe.

Enums
LINK_TO_DIGITAL_CONTENT_OFFER Une offre d'achat de contenu numérique.

ExternalOfferAppCategory

Catégorie de l'application téléchargée. Pour en savoir plus sur les catégories d'applications, consultez https://support.google.com/googleplay/android-developer/answer/9859673.

Enums
EXTERNAL_OFFER_APP_CATEGORY_UNSPECIFIED Non spécifié, ne pas utiliser.
APP L'application est classée dans la catégorie d'applications.
GAME L'application est classée dans la catégorie des jeux.

ExternalContentLinkDetails

Détails spécifiques au programme de liens vers des contenus externes.

Représentation JSON 
{
  "linkType": enum (ExternalContentLinkType),
  "installedAppPackage": string,
  "externalAppCategory": enum (ExternalContentAppCategory)
}
Champs
installedAppPackage

string

Facultatif. Nom du package de l'application téléchargée lors de cette transaction. Uniquement requis pour l'installation de l'application.
externalAppCategory

enum (ExternalContentAppCategory)

Facultatif. Catégorie de l'application téléchargée. Celle-ci doit correspondre à la catégorie indiquée dans la Play Console lors de la vérification externe de l'application. Uniquement requis pour l'installation de l'application.

ExternalContentLinkType

Type de lien externe.

Enums
EXTERNAL_CONTENT_LINK_TYPE_UNSPECIFIED Non spécifié, ne pas utiliser.
LINK_TO_DIGITAL_CONTENT_OFFER Une offre d'achat de contenu numérique.

ExternalContentAppCategory

Catégorie de l'application téléchargée. Pour en savoir plus sur les catégories d'applications, consultez https://support.google.com/googleplay/android-developer/answer/9859673.

Enums
EXTERNAL_CONTENT_APP_CATEGORY_UNSPECIFIED Non spécifié, ne pas utiliser.
APP L'application est classée dans la catégorie d'applications.
GAME L'application est classée dans la catégorie des jeux.

Méthodes

createexternaltransaction

 Crée une nouvelle transaction externe.

getexternaltransaction

 Obtient une transaction externe existante.

refundexternaltransaction

 Remboursements ou remboursements partiels d'une transaction externe existante.

Codes d'erreur

Les opérations de cette ressource renvoient les codes d'erreur HTTP suivants :

Code d'erreur Motif Description Solution