Passer au contenu
/
Désactiver un plan

Subscriptions API (2.0)

Présentation

  • Version : 2.0
  • Serveurs : https://api.xsolla.com/merchant/v2/

Cette référence API décrit les endpoints pour la gestion des abonnements, des coupons et des promotions. Pour plus d'informations sur les abonnements, consultez le guide du produit et le glossaire.

Télécharger la description d'OpenAPI
index.json
index.yaml
Langues
Serveurs
Mock server
https://xsolla.redocly.app/_mock/fr/api/subscriptions/

Jeton

Opérations

Plans

Opérations

Créer un plan

Requête

Crée un plan d'abonnement.

Sécurité
basicAuth
Chemin
project_idintegerobligatoire

ID de projet.

Corpsapplication/jsonobligatoire
billing_retryobject

Informations sur la relance de la facturation.

chargeobjectobligatoire

Informations de facturation.

charge.​amountnumber(float)

Montant de facturation.

charge.​currencystring

Devise d'achat. Code de devise à trois lettres selon la norme ISO 4217.

charge.​periodobjectobligatoire

Période de facturation.

charge.​period.​typestringobligatoire

Unité de temps. La valeur peut être day, month ou lifetime.

Enum"day""month""lifetime"
charge.​period.​valueintegerobligatoire

Nombre d'unités de temps. La valeur dépend du paramètre type et peut être :
- de 1 à 366, si type est défini sur day ;
- de 1 à 12, si type est défini sur month ;
- 0 si type est défini sur lifetime.

charge.​pricesArray of objects

Liste des prix dans différentes devises.

descriptionobject

Description du plan. La valeur est constituée de paires "localization":"plan description".

expirationobject

Informations sur l'expiration de l'abonnement.

external_idstring

ID externe du plan (32 caractères).

grace_periodobject

Informations sur le délai de grâce.

group_idstring or null

ID du groupe auquel le plan est lié.

idinteger

ID de plan d'abonnement.

nameobjectobligatoire

Nom du plan. La valeur est constituée de paires "localization":"plan name".

name.​arstring

Arabe.

name.​bgstring

Bulgare.

name.​cnstring

Chinois (simplifié).

name.​csstring

Tchèque.

name.​destring

Allemand.

name.​enstring

Anglais.

name.​esstring

Espagnol.

name.​frstring

Français.

name.​hestring

Hébreu.

name.​itstring

Italien.

name.​jastring

Japonais.

name.​kostring

Coréen.

name.​plstring

Polonais.

name.​ptstring

Portugais.

name.​rostring

Roumain.

name.​rustring

Russe.

name.​thstring

Thaïlandais.

name.​trstring

Turc.

name.​twstring

Chinois (traditionnel).

name.​vistring

Vietnamien.

project_idinteger

ID de projet.

refund_periodinteger or null

Période durant laquelle l'utilisateur peut se faire rembourser le paiement d'un abonnement (en jours).

statusobject
tagsArray of strings

Balises du plan.

trialobject

Informations sur la période d'essai.

curl -i -X POST \
  -u <username>:<password> \
  'https://xsolla.redocly.app/_mock/fr/api/subscriptions/projects/{project_id}/subscriptions/plans' \
  -H 'Content-Type: application/json' \
  -d '{
    "billing_retry": {
      "value": 1
    },
    "charge": {
      "amount": 10,
      "currency": "USD",
      "period": {
        "type": "month",
        "value": 1
      },
      "prices": [
        {
          "amount": 8,
          "currency": "EUR",
          "setup_fee": 1.5
        },
        {
          "amount": 1000,
          "currency": "JPY",
          "setup_fee": 2.5
        }
      ]
    },
    "description": {
      "en": "2x more experience!"
    },
    "expiration": {
      "type": "day",
      "value": null
    },
    "external_id": "exp",
    "grace_period": {
      "type": "day",
      "value": 2
    },
    "name": {
      "en": "Experience boost"
    },
    "refund_period": null,
    "status": {
      "value": "active"
    },
    "trial": {
      "type": "day",
      "value": 7
    }
  }'

Réponses

Сreated.

Corpsapplication/json
external_idstring
plan_idinteger
Réponse
application/json
{
  "external_id": "exp",
  "plan_id": 241082
}

Désactiver un plan

Requête

Désactive un plan d'abonnement.

Sécurité
basicAuth
Chemin
project_idintegerobligatoire

ID de projet.

plan_idintegerobligatoire

ID de plan.

curl -i -X DELETE \
  -u <username>:<password> \
  'https://xsolla.redocly.app/_mock/fr/api/subscriptions/projects/{project_id}/subscriptions/plans/{plan_id}'

Réponses

No content.

Activer un plan

Requête

Active un plan d'abonnement.

Sécurité
basicAuth
Chemin
project_idintegerobligatoire

ID de projet.

plan_idintegerobligatoire

ID de plan.

curl -i -X PATCH \
  -u <username>:<password> \
  'https://xsolla.redocly.app/_mock/fr/api/subscriptions/projects/{project_id}/subscriptions/plans/{plan_id}'

Réponses

No content.

Produits

Opérations

Subscription management

Opérations

Paiements

Opérations

Promotions

Opérations

Coupons

Opérations

Subscription management

Opérations