Actions43
- Subaccount Actions
- Customer Actions
- Refund Actions
- Installment Actions
- Invoice Actions
- Subscription Actions
- Pix Key Actions
- QR Code Static Actions
- Payment Request Actions
- Charge Actions
- Psp (Payment Service Providers) Actions
Overview
This node operation updates the value of a subscription in the Woovi API. It is useful for scenarios where you need to change the amount charged for future installments of a subscription, particularly when using PIX automatic payments that accept dynamic values. For example, if a customer upgrades their subscription plan or changes the payment amount, this operation allows you to update the subscription value accordingly.
Use Case Examples
- Updating the subscription value to 10000 cents for a specific subscription ID to reflect a new payment amount.
- Adjusting subscription charges dynamically based on customer requests or promotions.
Properties
| Name | Meaning |
|---|---|
| Subscription ID | The unique identifier of the subscription to update. |
| New Value (cents) | The new value in cents to set for future subscription installments. This only works if PIX automatic accepts dynamic value. |
Output
JSON
id- The ID of the updated subscription.value- The new value set for the subscription in cents.status- The status of the update operation, indicating success or failure.
Dependencies
- Woovi API with API key credential for authentication
Troubleshooting
- Ensure the subscription ID is valid and exists in the Woovi system to avoid errors.
- Verify that the new value is a positive number and compatible with PIX automatic dynamic value acceptance.
- Common error: 'Unsupported resource/operation' indicates the resource or operation name is incorrect or not implemented.
- API errors from Woovi may occur if authentication fails or if the subscription cannot be updated due to business rules.
Links
- Woovi API Documentation - Official API documentation for Woovi, including subscription management endpoints.