Method: purchases.subscriptions.cancel

Obsolète : utilisez plutôt purchases.subscriptionsv2.cancel. Annule l'achat d'un abonnement par un utilisateur. L'abonnement reste valide jusqu'à son expiration. Une version plus récente est disponible sur purchases.subscriptionsv2.cancel pour une meilleure compatibilité avec la bibliothèque cliente.

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 de package de l'application pour laquelle cet abonnement a été acheté (par exemple, "com.exemple.XXX").
subscriptionId

string

Remarque : Depuis le 21 mai 2025, subscriptionId n'est plus obligatoire et n'est pas recommandé pour les abonnements avec modules complémentaires. ID de l'abonnement acheté (par exemple, "monthly001").
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 d'annulation de l'abonnement acheté. Notez que ce champ n'est compatible qu'avec la requête HTTP. Il n'est pas disponible dans les bibliothèques clientes. Les utilisateurs de la bibliothèque cliente peuvent utiliser purchases.subscriptionsv2.cancel à la place.

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"

Niveaux d'accès 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 d'annulation non spécifié.
USER_REQUESTED_STOP_RENEWALS Annulation demandée par l'utilisateur. L'abonnement peut être restauré. Il arrête uniquement le prochain renouvellement de l'abonnement. Pour un abonnement à paiement échelonné, les utilisateurs doivent toujours 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 Annulation 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 à paiement échelonné, les utilisateurs n'auront pas à effectuer le prochain paiement 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 d'annulation n'est spécifié.