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.
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/&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â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. |
subscriptionId | integer | Obrigatório. ID da assinatura. |
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. |
- 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"
}
Exemplos de resposta:
200
— O valor da cobrança foi alterado com êxito400
— A assinatura não está ativa404
— A assinatura não foi encontrada
Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.