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.

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 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/<merchant_id>.
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

Vá para sua conta para encontrar estes parâmetros:

merchant_id é mostrado:
- Na seção Company settings > Company.
- No URL na barra de endereços do navegador em qualquer página da conta. O URL tem o seguinte formato: https://xsolla.com/for/free-to-play-pc/account/<merchant_id>.
api_key é exibido na conta apenas uma vez quando é criado e deve ser armazenado do seu lado. Você pode criar uma nova chave na seguinte seção:
- Company settings > API keys
- Settings > API keys

Vá para sua conta para encontrar estes parâmetros:

merchant_id é mostrado:
- Na seção Company settings > Company.
- No URL na barra de endereços do navegador em qualquer página da conta. O URL tem o seguinte formato: https://xsolla.com/for/premium-pc-games/account/<merchant_id>.
api_key é exibido na conta apenas uma vez quando é criado e deve ser armazenado do seu lado. Você pode criar uma nova chave na seguinte seção:
- Company settings > API keys
- Settings > API keys

Vá para sua conta para encontrar estes parâmetros:

merchant_id é mostrado:
- Na seção Company settings > Company.
- No URL na barra de endereços do navegador em qualquer página da conta. O URL tem o seguinte formato: https://xsolla.com/for/web-games/account/<merchant_id>.
api_key é exibido na conta apenas uma vez quando é criado e deve ser armazenado do seu lado. Você pode criar uma nova chave na seguinte seção:
- Company settings > API keys
- Settings > API keys

Passar como parâmetros de caminho:

Parâmetro	Tipo	Descrição
projectId	integer	Obrigatório. ID do projeto.

Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.

Você pode encontrar esse parâmetro na sua conta ao lado do nome do projeto.

Parâmetro	Tipo	Descrição
subscriptionId	integer	Obrigatório. ID da assinatura.

Passe no corpo do pedido:

Parâmetro	Tipo	Descrição
quantia	float	Obrigatório. Valor da cobrança.
moeda	string	Obrigató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

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}

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

Obrigado pelo seu feedback!

Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.

Última atualização: 24 de Agosto de 2026

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

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

projectId

subscriptionId

quantia

moeda