ProAbono icon

ProAbono

Interact with ProAbono API

Actions19

Overview

This node integrates with the ProAbono API to create a new subscription for a customer. It allows users to specify which customer the subscription is for, select an offer to subscribe to, and optionally customize details such as start date, title, description, and various fees.

Common scenarios include automating subscription management workflows where you need to programmatically add subscriptions to customers based on predefined offers. For example, when a new user signs up in your system, you can automatically create a subscription for them using this node.

Practical examples:

  • Creating a subscription immediately after a customer registration.
  • Scheduling a subscription to start at a future date.
  • Overriding default pricing or descriptions of the subscription offer for specific customers.

Properties

Name Meaning
Reference Customer The unique identifier used within your own application to identify the customer for whom the subscription is created.
Reference Offer The offer to subscribe the customer to. Can be selected from a list of available offers or specified via an expression.
Additional Fields Optional fields to customize the subscription:
- Date Start The date when the subscription will start. If omitted, the subscription starts immediately.
- Title Override the default title of the subscription copied from the offer.
- Description Override the default description of the subscription copied from the offer.
- UpFront Fee Override the upfront (setup) fee amount in cents (e.g., 12797 means €127.97).
- Recurring Amount Override the recurring fee amount in cents (e.g., 59297 means €592.97).
- Termination Fee Override the termination fee amount in cents (e.g., 9000 means €90.00).

Output

The node outputs JSON data representing the newly created subscription object returned by the ProAbono API. This typically includes details such as subscription ID, customer reference, offer details, start date, fees, status, and other metadata related to the subscription.

No binary data output is indicated.

Dependencies

  • Requires an active ProAbono API account.
  • Needs API credentials including a business identifier, agent key, and API key configured in n8n credentials.
  • The node uses the ProAbono REST API endpoint dynamically constructed using the business ID.
  • The "Reference Offer" property loads options dynamically via the ProAbono API.

Troubleshooting

  • Invalid Customer Reference: If the provided customer identifier does not exist or is incorrect, the API may return an error. Verify the customer ID before running the node.
  • Offer Not Found: Selecting or specifying an invalid offer reference will cause failure. Use the dynamic dropdown or ensure the expression resolves correctly.
  • Date Format Issues: The "Date Start" field must be a valid datetime; otherwise, the API might reject the request.
  • Fee Amounts: Fees must be specified in cents as integers. Providing decimal or string values may cause errors.
  • Authentication Errors: Ensure that the API credentials are correct and have sufficient permissions.
  • API Endpoint Errors: The base URL depends on the business ID; if misconfigured, requests will fail.

Links and References

Discussion