Actualización masiva de precios de suscripción

Last updated: August 18, 2026

Actualiza el precio de múltiples suscripciones en una sola llamada API. Útil para ajustar precios según las tasas de cambio de moneda, precios estacionales o cambios promocionales.

Endpoint

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

Autenticación

Incluye tu clave API secreta en el x-api-key encabezado.

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

Métodos de actualización

Puedes actualizar suscripciones especificando ya sea los IDs de suscripción o los IDs de plan.

Método 1: Actualizar por IDs de suscripción

Actualiza solo las suscripciones específicas listadas en el subscriptionIds arreglo.

Parámetros del cuerpo de la solicitud:

  • subscriptionIds (array, requerido): Lista de IDs de suscripción para actualizar

  • amount (número, requerido): Nuevo importe del precio

Ejemplo:

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: Actualizar por IDs de plan

Actualiza todas las suscripciones activas generadas a partir de los planes especificados en el planId array.

Parámetros del cuerpo de la solicitud:

  • planId (array, requerido): Lista de IDs de plan

  • amount (número, requerido): Nuevo monto del precio

Ejemplo:

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
}'

Cuando se aplica el cambio de precio

El nuevo precio se aplica al próximo ciclo de facturación programado para cada suscripción.

Ejemplo:

  • Fecha del próximo cargo de suscripción: 15 de marzo de 2026

  • Actualizas el precio el 10 de marzo de 2026

  • El nuevo precio se cobrará el 15 de marzo de 2026

Casos de uso comunes

Ajustes de tipo de cambio: Actualiza los precios de suscripción al comienzo de cada mes según los tipos de cambio del USD para monedas locales.

Correcciones de precios: Corregir precios incorrectos en varias suscripciones en una sola operación.

Notas importantes

Al usar planId: Todas las suscripciones activas asociadas a ese plan se actualizarán. Verifique que este sea el comportamiento deseado antes de ejecutar.

Sin límite de actualización: No hay límite en la cantidad de suscripciones que puedes actualizar en una sola solicitud. Sin embargo, recomendamos probar con un lote pequeño primero.

Prueba antes de actualizaciones masivas: Ejecuta una prueba con un número reducido de suscripciones para validar el comportamiento antes de realizar actualizaciones a gran escala.

Respuesta

La API devuelve una confirmación de éxito una vez que se procesa la actualización masiva.

Respuesta de éxito:

{  "success": true,  "updated": 250,  "message": "Subscription prices updated successfully"}

¿Necesitas ayuda?

Si tienes preguntas o necesitas ayuda con actualizaciones masivas de precios, por favor contáctanos support@rebill.com.