Atualização em massa dos preços de assinatura

Last updated: August 18, 2026

Atualize o preço de várias assinaturas em uma única chamada de API. Útil para ajustar preços com base nas taxas de câmbio, preços sazonais ou alterações promocionais.

Endpoint

POST https://api.rebill.com/v3/subscriptions/bulk-update-price

Autenticação

Inclua sua chave de API secreta no cabeçalho x-api-key cabeçalho.

--header 'x-api-key: your-secret-api-key'

Métodos de atualização

Você pode atualizar assinaturas especificando IDs de assinatura ou IDs de plano.

Método 1: Atualizar por IDs de assinatura

Atualiza apenas as assinaturas específicas listadas no subscriptionIds array.

Parâmetros do corpo da requisição:

  • subscriptionIds (array, required): Lista de IDs de assinatura para atualizar

  • amount (number, required): Novo valor do preço

Exemplo:

curl --location --request POST 'https://api.rebill.com/v3/subscriptions/bulk-update-price' \--header 'Content-Type: application/json' \--header 'x-api-key: your-secret-api-key' \--data-raw '{
  "subscriptionIds": ["sub_xxx", "sub_yyy"],
  "amount": 123456.00
}'

Método 2: Atualizar por IDs de plano

Atualiza todas as assinaturas ativas geradas a partir dos planos especificados no planId array.

Parâmetros do corpo da requisição:

  • planId (array, obrigatório): Lista de IDs de plano

  • amount (number, obrigatório): Novo valor do preço

Exemplo:

bash

curl --location --request POST 'https://api.rebill.com/v3/subscriptions/bulk-update-price' \--header 'Content-Type: application/json' \--header 'x-api-key: your-secret-api-key' \--data-raw '{
  "planId": ["pl_xxx", "pl_yyy"],
  "amount": 123456.00
}'

Quando a mudança de preço se aplica

O novo preço se aplica ao próximo ciclo de cobrança programado para cada assinatura.

Exemplo:

  • Data da próxima cobrança da assinatura: 15 de março de 2026

  • Você atualiza o preço em 10 de março de 2026

  • O novo preço será cobrado em 15 de março de 2026

Casos de uso comuns

Ajustes de câmbio: Atualizar preços de assinatura no início de cada mês com base nas taxas de câmbio do USD para moedas locais.

Correções de preço: Corrija preços incorretos em várias assinaturas em uma única operação.

Observações importantes

Ao usar planId: Todas as assinaturas ativas associadas a esse plano serão atualizadas. Verifique se este é o comportamento desejado antes de executar.

Sem limite de atualização: Não há limite para o número de assinaturas que você pode atualizar em uma única solicitação. No entanto, recomendamos testar com um lote pequeno primeiro.

Teste antes de atualizações em massa: Execute um teste com um número reduzido de assinaturas para validar o comportamento antes de realizar atualizações em grande escala.

Resposta

A API retorna uma confirmação de sucesso assim que a atualização em massa é processada.

Resposta de sucesso:

{  "success": true,  "updated": 250,  "message": "Preços de assinatura atualizados com sucesso"}

Precisa de ajuda?

Se você tem dúvidas ou precisa de assistência com atualizações em massa de preços, entre em contato support@rebill.com.