Method: purchases.subscriptions.cancel

Annule l'achat d'un abonnement par un utilisateur. L'abonnement reste valide jusqu'à sa date d'expiration. Une version plus récente est disponible sur purchases.subscriptionsv2.cancel pour une meilleure compatibilité avec les bibliothèques clientes.

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 pas obligatoire et n'est pas recommandé pour les abonnements avec 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 compatible qu'avec la requête HTTP. Elle 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 de résiliation non spécifié.
USER_REQUESTED_STOP_RENEWALS L'utilisateur a demandé la résiliation, mais l'abonnement peut être rétabli. Elle arrête uniquement le prochain renouvellement de l'abonnement. Pour un abonnement avec paiements échelonnés, les utilisateurs doivent toujours terminer la période d'engagement. Pour en savoir plus sur les renouvellements et les paiements, consultez https://developer.android.com/google/play/billing/subscriptions#installments.
DEVELOPER_REQUESTED_STOP_PAYMENTS La résiliation a été demandée par le développeur et l'abonnement ne peut pas être restauré. Le prochain paiement de l'abonnement est alors arrêté. Pour un abonnement avec paiements échelonnés, 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 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é.