Method: purchases.subscriptions.cancel

Annule l'achat d'un abonnement par un utilisateur. L'abonnement reste valide jusqu'à sa date d'expiration.

Requête HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:cancel

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
packageName

string

Nom du package de l'application pour laquelle cet abonnement a été acheté (par exemple, "com.un.truc").

subscriptionId

string

Remarque: Depuis le 21 mai 2025, subscriptionId n'est plus obligatoire et n'est pas recommandé pour les abonnements avec des modules complémentaires. ID de l'abonnement acheté (par exemple, "mensuel001").

token

string

Jeton fourni à l'appareil de l'utilisateur lors de la souscription de l'abonnement.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "cancellationType": enum (CancellationType)
}
Champs
cancellationType

enum (CancellationType)

Facultatif. Type de résiliation de l'abonnement souscrit. Notez que ce champ n'est accepté que dans la requête HTTP. Il n'est pas disponible dans les bibliothèques clientes.

Corps de la réponse

Si la requête aboutit, le corps de la réponse est vide.

Échantillon

Voici un exemple de requête:

curl -X POST \
  -H "Accept: application/json" \
  "https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/subscriptions/monthly.premium.plan/tokens/EXAMPLE_TOKEN_STRING_12345:cancel"

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/androidpublisher

CancellationType

Type d'annulation demandé par le développeur.

Enums
CANCELLATION_TYPE_UNSPECIFIED Type de résiliation non spécifié.
USER_REQUESTED_STOP_RENEWALS Annulation demandée par l'utilisateur. L'abonnement peut être rétabli. Cette opération ne fait que stopper le prochain renouvellement de l'abonnement. Pour un abonnement en plusieurs versements, les utilisateurs doivent terminer la période d'engagement. Pour en savoir plus sur les renouvellements et les paiements, consultez la page https://developer.android.com/google/play/billing/subscriptions#installments.
DEVELOPER_REQUESTED_STOP_PAYMENTS Résiliation demandée par le développeur. L'abonnement ne peut pas être restauré. Il arrête le prochain paiement de l'abonnement. Pour un abonnement en plusieurs versements, les utilisateurs n'auront pas à payer le prochain versement et à terminer la période d'engagement. Pour en savoir plus sur les renouvellements et les paiements, consultez la page https://developer.android.com/google/play/billing/subscriptions#installments. Il s'agit du comportement par défaut lorsqu'aucun type de résiliation n'est spécifié.