Saltar al contenido
/
Actualizar plan

Subscriptions API (2.0)

Información general

  • Versión: 2.0
  • Servidores: https://api.xsolla.com/merchant/v2/

Esta referencia de API describe los extremos para administrar suscripciones, cupones y promociones. Para obtener más información sobre las suscripciones, consulta la página guía del producto y el glosario.

Descargar descripción de OpenAPI
index.json
index.yaml
Idiomas
Servidores
Mock server
https://xsolla.redocly.app/_mock/es/api/subscriptions/

Token

Operaciones

Planes

Operaciones

Activar plan

Solicitud

Activa un plan de suscripción.

Seguridad
basicAuth
Ruta
project_idintegerrequerido

ID de proyecto.

plan_idintegerrequerido

ID del plan.

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

Respuestas

No content (Sin contenido).

Actualizar plan

Solicitud

Actualiza los parámetros del plan de suscripción.

Seguridad
basicAuth
Ruta
project_idintegerrequerido

ID de proyecto.

plan_idintegerrequerido

ID del plan.

Cuerpoapplication/jsonrequerido
billing_retryobject

Detalles del reintento de facturación.

chargeobject

Datos de facturación.

descriptionobject

Descripción del plan. El valor se compone de pares de "localization":"plan description".

expirationobject

Datos de finalización de la suscripción.

external_idstring

ID externo del plan (32 caracteres).

grace_periodobject

Detalles del periodo de gracia.

group_idstring

ID del grupo al que está vinculado el plan.

nameobject

Nombre del plan. El valor se compone de pares de "localization":"plan name".

refund_periodinteger or null

Periodo de tiempo durante el cual el usuario puede reembolsar el pago de un plan de suscripción (en días).

statusobject
tagsArray of strings

Etiquetas del plan.

trialobject

Detalles del periodo de prueba. Si no se transmite este parámetro, se emplean los valores por defecto (0 días).

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

Respuestas

ACEPTAR.

Cuerpoapplication/json
Respuesta
application/json
{
  "billing_retry": {
    "value": 1
  },
  "charge": {
    "amount": 20,
    "currency": "USD",
    "period": { … },
    "prices": [ … ]
  },
  "description": {
    "en": "3x more experience!"
  },
  "expiration": {
    "type": "day",
    "value": 0
  },
  "external_id": "exp",
  "grace_period": {
    "type": "day",
    "value": 2
  },
  "group_id": null,
  "id": 241082,
  "localized_name": "Experience boost",
  "name": {
    "en": "Experience boost"
  },
  "project_id": 40797,
  "refund_period": null,
  "status": {
    "value": "active"
  },
  "tags": [],
  "trial": {
    "type": "day",
    "value": 7
  },
  "type": "all"
}

Eliminar plan

Solicitud

Elimina un plan de suscripción.

Seguridad
basicAuth
Ruta
project_idintegerrequerido

ID de proyecto.

plan_idintegerrequerido

ID del plan.

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

Respuestas

No content (Sin contenido).

Productos

Operaciones

Subscription management

Operaciones

Pagos

Operaciones

Promociones

Operaciones

Cupones

Operaciones

Subscription management

Operaciones