Para cambiar el importe del cargo de una suscripción activa, ejecute una solicitud HTTP-PATCH https://subscriptions.xsolla.com/api/v1/projects/{projectId}/subscriptions/{subscriptionId}/price.

Tras modificar el importe del cargo, se notifica al usuario por correo electrónico, y el nuevo importe entra en vigor a partir del siguiente periodo de facturación.

Para cambiar el importe del cargo de las nuevas suscripciones, utilice el método Actualizar plan. El nuevo importe solo se aplica a las nuevas suscripciones, y todas las suscripciones existentes seguirán con las condiciones anteriores.

La solicitud debe contener un encabezado Authorization: Basic <your_authorization_basic_key>, en el cual <your_authorization_basic_key> es el par merchant_id:api_key codificado según el estándar Base64.

Vaya a Cuenta del editor para encontrar estos parámetros:

merchant_id se muestra:
- En la sección Company settings > Company .
- En la URL de la barra de direcciones del navegador en cualquier página de Cuenta del editor. La URL tiene el siguiente formato: https://publisher.xsolla.com/<merchant_id>.
api_key se muestra en Cuenta del editor solamente cuando se crea, y debe almacenarse en su lado. Puede crear una nueva clave en la siguiente sección:
- Company settings > API keys
- Project settings > API keys

Ve a tu cuenta para encontrar estos parámetros:

merchant_id se muestra:
- En la sección Configuración de la empresa > Empresa.
- En la URL en la barra de direcciones del navegador en cualquier página de la cuenta. La URL tiene el siguiente formato: https://xsolla.com/for/free-to-play-pc/account/<merchant_id>.
api_key se muestra en la cuenta solo una vez cuando se crea y debe almacenarse en tu lado. Puedes crear una nueva clave en la siguiente sección:
- Configuración de la empresa > Claves de API
- Configuración > Claves de API

Ve a tu cuenta para encontrar estos parámetros:

merchant_id se muestra:
- En la sección Configuración de la empresa > Empresa.
- En la URL en la barra de direcciones del navegador en cualquier página de la cuenta. La URL tiene el siguiente formato: https://xsolla.com/for/premium-pc-games/account/<merchant_id>.
api_key se muestra en la cuenta solo una vez cuando se crea y debe almacenarse en tu lado. Puedes crear una nueva clave en la siguiente sección:
- Configuración de la empresa > Claves de API
- Configuración > Claves de API

Ve a tu cuenta para encontrar estos parámetros:

merchant_id se muestra:
- En la sección Configuración de la empresa > Empresa.
- En la URL en la barra de direcciones del navegador en cualquier página de la cuenta. La URL tiene el siguiente formato: https://xsolla.com/for/web-games/account/<merchant_id>.
api_key se muestra en la cuenta solo una vez cuando se crea y debe almacenarse en tu lado. Puedes crear una nueva clave en la siguiente sección:
- Configuración de la empresa > Claves de API
- Configuración > Claves de API

Transmitir como parámetros de ruta:

Parámetro	Tipo	Descripción
projectId	integer	Obligatorio. ID del proyecto.

Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto.

Puedes encontrar este parámetro en tu cuenta junto al nombre del proyecto.

Parámetro	Tipo	Descripción
subscriptionId	integer	Obligatorio. ID de suscripción.

Transmitir en el cuerpo de la solicitud:

Parámetro	Tipo	Descripción
importe	float	Obligatorio. Valor del importe del cargo.
moneda	string	Obligatorio. Código de moneda de tres letras conforme a la norma ISO 4217.

Ejemplo de solicitud:

Copy

Full screen

Small screen

1curl -X PATCH \
2'https://subscriptions.xsolla.com/api/v1/projects/{project_id}/subscriptions/{subscription_id}/price' \
3  -H 'accept: application/json' \
4  -H 'Authorization: Basic'
5
6{
7  "amount": 4.99,
8  "currency": "USD"
9}

Ejemplos de respuesta:

200 - El importe del cargo se modificó correctamente
400 - La suscripción no está activa
404 - No se encontró la suscripción

¡Gracias por tu mensaje!

Nos ayudará a mejorar tu experiencia.

Última actualización: 24 de Agosto de 2026

¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.