Cómo cambiar el importe del cargo de una suscripción activa
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 Project settings > Webhooks.
- En la sección Company settings > Company.
- En la URL de la barra de direcciones del navegador en cualquier página de la Cuenta del editor. La URL tiene el siguiente formato:
https://publisher.xsolla.com/&lt;merchant ID>/<Publisher Account section>
.
api_key
se muestra en la 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
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. |
subscriptionId | integer | Obligatorio. ID de suscripción. |
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. |
- curl
curl -X PATCH \
'https://subscriptions.xsolla.com/api/v1/projects/{project_id}/subscriptions/{subscription_id}/price' \
-H 'accept: application/json' \
-H 'Authorization: Basic'
{
"amount": 4.99,
"currency": "USD"
}
Ejemplos de respuesta:
200
- El importe del cargo se modificó correctamente400
- La suscripción no está activa404
- No se encontró la suscripción
¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.