Helcim Integrations Partner Program

The Helcim Integrations Partner Program enables partners to receive a portion of Helcim’s revenue earned on each transaction processed by a Qualified Merchant through or as a result of the Technical Integration provided and maintained by a Partner.

📘

This program applies exclusively to technical integrations built to Helcim’s V2 API or HelcimPay.js. This includes the Payment API, Smart Terminal API, and Subscription Manager API.

For seamless attribution of Partner transactions flowing through the API integration, Partners will be required to tag all transactions with a unique partner token provided during the onboarding process, post contract finalization.

The unique partner token is crucial to ensure correct attribution of all transactions that are processed through the Partner Technical Integration and will be linked to the monthly profit share calculations at the close of every month. With the launch of the Integrations Partner Program, Helcim will not have the functionality to reconcile retroactively any missed transactions on account of incorrect tagging.

Getting Started With Your Integration

To learn more about integrating with the Helcim V2 API, or HelcimPay.js, you can visit the following pages in our developer documentation.

• Helcim API
• HelcimPay

Step 1: Creating a test account

To get started we’ll want to set you up with a developer test account, so that you can test your integration to the Helcim API.

You can connect with the Helcim Tier 2 Support team or the Partnership Team when you’re ready to get started and we will get you set up with a test account and assist you with integrating to Helcim.

Step 2: Adding your Unique Partner Token

Adding your partner token to your request is critical for ensuring programmatic rev share for payments processed through your integration are attributed to your business correctly.

Include your partner token in the request header for all payment requests you send to the Payment API, or in your HelcimPay.js Initialize requests.

• partner-token: Provided by your Partnership Specialist to be included in the header of all API requests.

Step 3: Validate your Partner Token was received

Validating that the Helcim system received your request and attributed it to your partner token is as simple as reviewing the header of the API response that you received.

• Review the header of the response you receive from Helcim.
• They will contain an is-valid-partner-token parameter that will have a value or 1 or 0.
  • If is-valid-partner-token is 1, you have successfully added the partner token to your request.
  • If is-valid-partner-token is 0, there is an error with your the partner token in your request.