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 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éfinie 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 avant 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. 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 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 signalent des transactions de facturation alternative. 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. Google ne vous facturera pas ces transactions.

OneTimeExternalTransaction

Représente une transaction unique.

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

string

Uniquement en entrée. Fourni lors de l'appel à la 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 (comme une 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 à la création. Récupéré auprès du client lorsque le parcours de facturation alternatif est lancé. Obligatoire uniquement pour le premier achat.
migratedTransactionProgram

enum (ExternalTransactionProgram)

Uniquement en entrée. Fourni lors de l'appel à la création. 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.
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écurrente qui n'appartient à aucune autre catégorie spécifique.

ExternalTransactionProgram

Représente le programme de transactions externes dont l'utilisateur bénéficie 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 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 du gestionnaire de 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'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écurrente 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".

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.

Codes d'erreur

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

Code d'erreur Motif Solution
5xx Erreur générique sur le serveur Google Play. Réessayez d'envoyer votre demande.

Si le problème persiste, contactez votre responsable de compte Google Play ou envoyez une demande d'assistance. Pensez à consulter le tableau de bord d'état Play pour connaître les éventuelles interruptions de service connues.
409 Erreur de mise à jour simultanée.

Une tentative de mise à jour d'un objet en cours de mise à jour a été effectuée. Par exemple, un achat est confirmé en appelant la méthode acknowledgePurchase() de la bibliothèque Play Billing et la méthode purchases.products.acknowledge de l'API Play Developer en même temps.

 Réessayez d'envoyer votre demande.