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.

Nota

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/&amp;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ámetroTipoDescripción
projectId
integerObligatorio. ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto.
subscriptionId
integerObligatorio. ID de suscripción.
Transmitir en el cuerpo de la solicitud:
ParámetroTipoDescripción
importe
floatObligatorio. Valor del importe del cargo.
moneda
stringObligatorio. Código de moneda de tres letras conforme a la norma ISO 4217.
Ejemplo de solicitud:
Copy
Full screen
Small screen
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ó correctamente
  • 400 - La suscripción no está activa
  • 404 - No se encontró la suscripción
¿Te ha resultado útil este artículo?
¡Gracias!
¿Hay algo en lo que podamos mejorar? Mensaje
Lo sentimos
Por favor, cuéntanos por qué no te ha resultado útil este artículo. Mensaje
¡Gracias por tu mensaje!
Nos ayudará a mejorar tu experiencia.
Última actualización: 31 de Julio de 2024

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

Informar de un problema
Nos esforzamos por ofrecer contenido de calidad. Tus comentarios nos ayudan a mejorar.
Déjanos tu correo electrónico para que te podamos responder
¡Gracias por tu mensaje!