Como alterar o valor da cobrança de uma assinatura ativa

Para alterar o valor da cobrança de uma assinatura ativa, execute uma solicitação https://subscriptions.xsolla.com​/api/v1/projects/{projectId}/subscriptions/{subscriptionId}/price HTTP-PATCH.

Observação

Depois de alterar o valor da cobrança, o usuário é notificado por e-mail e o novo valor entra em vigor a partir do próximo período de cobrança.

Para alterar o valor da cobrança de novas assinaturas, use o método Atualizar Plano. O novo valor só se aplica a novas assinaturas, e todas as assinaturas existentes continuarão sob os termos antigos.

A solicitação deve conter um cabeçalho Authorization: Basic <your_authorization_basic_key>, onde <your_authorization_basic_key> é o par merchant_id:api_key codificado de acordo com o padrão Base64.

Vá para a Conta de Distribuidor para localizar estes parâmetros:

  • merchant_id é mostrado:
    • Na seção Project settings > Webhooks.
    • Na seção Company settings > Company.
    • No URL da barra de endereços do navegador em qualquer página Conta de Distribuidor. O URL tem o seguinte formato: https://publisher.xsolla.com/&amp;lt;merchant ID>/<Publisher Account section>.
  • api_key é exibido na Conta de Distribuidor apenas uma vez quando é criada e deve ser armazenada do seu lado. Você pode criar uma nova chave na seguinte seção:
    • Company settings > API keys
    • Project settings > API keys

Passar como parâmetros de caminho:

ParâmetroTipoDescrição
projectId
integerObrigatório. ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.
subscriptionId
integerObrigatório. ID da assinatura.
Passe no corpo do pedido:
ParâmetroTipoDescrição
quantia
floatObrigatório. Valor da cobrança.
moeda
stringObrigatório. Código de três letras da moeda, de acordo com a norma ISO 4217.
Exemplo de solicitação:
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"
}

Exemplos de resposta:

  • 200 — O valor da cobrança foi alterado com êxito
  • 400 — A assinatura não está ativa
  • 404 — A assinatura não foi encontrada
Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Última atualização: 31 de Julho de 2024

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!