Actions20
- Payment Link Actions
- Form Actions
- Coupon Actions
Overview
This node integrates with the BCL Payment API to manage forms and their affiliate settings. Specifically, the Update Affiliate Settings operation for the Form resource allows users to modify affiliate-related configurations of a form. This is useful for enabling or disabling an affiliate program on a form, controlling whether affiliate information is displayed to end-users, and deciding if commission settings should override global defaults.
Practical scenarios include:
- Activating an affiliate program for a specific payment or registration form.
- Customizing the visibility of affiliate details on the form page.
- Applying custom commission rules for affiliates linked to that form.
Properties
| Name | Meaning |
|---|---|
| Form ID | The unique identifier of the form whose affiliate settings you want to update. |
| Affiliate Settings | A collection of affiliate-related options: |
| - Enable Affiliate: Enable or disable the affiliate program for this form (true/false). | |
| - Show Affiliate Info: Show or hide affiliate information on the form (true/false). | |
| - Override Commission Settings: Whether to override global commission settings (true/false). |
Output
The node outputs JSON data representing the response from the BCL API after updating the affiliate settings. This typically includes confirmation of the updated settings or error details if the update failed.
The output structure is an array of JSON objects corresponding to each input item processed, containing the API response data.
No binary data output is produced by this operation.
Dependencies
- Requires an API authentication token credential for the BCL Payment API.
- The node makes HTTP requests to the BCL API endpoint at
https://bcl.my/api. - Proper configuration of the API token credential in n8n is necessary for successful authentication.
Troubleshooting
- Authentication failed: If the API token is invalid or expired, the node will return an authentication error. Verify and update your API token credential.
- Validation errors: Occur if required parameters are missing or incorrectly formatted. Ensure the Form ID is valid and affiliate settings are properly set.
- Not found errors: If the specified Form ID does not exist, the API returns a "not found" error. Confirm the form exists before updating.
- Permission errors: If your API token lacks permission to update affiliate settings, a forbidden error will be returned.
- Empty affiliate settings: If no affiliate settings are provided, the request may fail or have no effect. Always specify at least one setting to update.
To handle errors gracefully, enable "Continue On Fail" in the node settings to process subsequent items even if some fail.
Links and References
- BCL Payment API Documentation (official API docs)
- n8n documentation on HTTP Request Node (for understanding underlying HTTP calls)
- General info on affiliate marketing programs and commission structures (varies by platform)