BCLInstall

Overview

This node integrates with the BCL Payment API to manage various resources such as payment links, forms, and coupons. Specifically for the Form resource and the Update TikTok Pixel operation, it allows users to update TikTok pixel tracking settings on a form. This includes enabling or disabling TikTok pixel tracking, setting the TikTok Pixel ID, enabling TikTok Events API, and providing an API token for authentication.

Use cases include:

• Enabling TikTok pixel tracking on a form to monitor user interactions and conversions.
• Configuring TikTok Events API integration for server-side event tracking.
• Updating TikTok pixel credentials securely without manual API calls.

Practical example: A marketer wants to track form submissions and conversions via TikTok ads. They can use this node to enable TikTok pixel tracking on their form and provide the necessary pixel ID and API token to start collecting data.

Properties

Output

The node outputs JSON data representing the response from the BCL API after updating the TikTok pixel settings on the specified form. The structure typically contains confirmation of the update or details of the updated form's TikTok pixel configuration.

If an error occurs, the output may contain an error object with fields such as:

• error: Description of the error.
• statusCode: HTTP status code returned by the API.
• timestamp: Time when the error occurred.
• resource: The resource involved ("form").
• operation: The operation attempted ("updateTiktokPixel").

No binary data is produced by this operation.

Dependencies

• Requires an active connection to the BCL Payment API.
• Needs an API token credential configured in n8n for authenticating requests.
• The node makes HTTP requests to the BCL API endpoint at https://bcl.my/api.
• For TikTok Events API integration, a valid TikTok API token must be provided in the input properties.

Troubleshooting

Common Issues

• Authentication failures: If the API token is invalid or expired, the node will return an authentication error.
• Validation errors: Missing required fields or invalid values in TikTok pixel settings can cause validation errors.
• Permission errors: Insufficient permissions to update the form resource will result in forbidden errors.
• Resource not found: Specifying a non-existent form ID will lead to a "not found" error.

Error Messages and Resolutions

• Authentication failed:
  Message: "Authentication failed: Invalid or expired API token."
  Resolution: Verify and update the API token credential in n8n.

• Validation error:
  Message: "Validation error: The API could not process your request."
  Resolution: Check that all required TikTok pixel settings are correctly filled and formatted.

• Bad request:
  Message: "Bad request: The request was improperly formatted or contained invalid parameters."
  Resolution: Review the input parameters for correctness.

• Forbidden:
  Message: "Forbidden: You do not have permission to access this resource."
  Resolution: Ensure the API token has sufficient permissions.

• Not found:
  Message: "Not found: The requested resource does not exist."
  Resolution: Confirm the form ID exists and is correct.

• Server error:
  Message: "Server error: The BCL server encountered an error."
  Resolution: Retry later or contact BCL support if the issue persists.

Links and References

• BCL Payment API Documentation (general reference to the API endpoint)
• TikTok Pixel Documentation (for understanding TikTok pixel tracking)
• TikTok Events API Guide (for server-side event tracking setup)