Creating an API Access Token
Creating your API Access Configuration
As part of the API authentication fields, you need to create an API access token in order to authenticate and gain access to the Helcim API. The API token is used for requests to the Helcim API and HelcimPay.
To get started:
- Log in to your Helcim Account.
- Click on
All Tools
and then on theIntegrations
. - Select
API Access Configuration
from the left menu. - Click on
New API Access
to get started.
- Enter a name for your API Access Configuration.
- Select the appropriate Access Restrictions for your API token.
- Click Create located on the top right of the page to save your configuration and generate your API token.
Legacy API tokens:
Please note that legacy Helcim API tokens cannot be used for Helcim API V2 endpoints. Depending on your unique integration, you can use a combination of legacy endpoints and V2 endpoints, however please note that legacy endpoints are now deprecated.
Configuring your API permissions
Each API access token that you create will have its own permissions and the access you select for your API configuration should depend on what you intend to do through the Helcim API. Review our suggested API permissions for common use cases below.
- General permissions will apply to general objects like Customer, Order, Products, and Others
- Settings permissions will apply to settings objects like VT Settings, Customer Settings, General Settings, and Others
- Transaction Processing
- None - cannot process any type of transaction
- Auth - for processing Verify and Preauth transactions
- Positive Transaction - for processing Purchase and Capture
- Admin - for processing Reversal, Refund
Transaction Processing permissions inherit the lower permissions levels when selected.
Recommended API permissions access
Product | Suggested Permissions |
---|---|
Helcim API | General: Read & Write Settings: Read & Write Transaction Processing: Admin |
HelcimPay | General: No access Settings: No access Transaction Processing: Positive Transaction |
Smart Terminal API | General: Read Settings: Read Transaction Processing: Admin |
HelcimPay permissions:
Please note that you cannot process Refund Transactions through HelcimPay.js. If you intend to use the same API token for requests to the Helcim Payment API through the Process Refund Transaction endpoint, then you would want to set Transaction Processing to Admin.
Invalid API permissions
If you attempt a function through the API with an api-token
that does not have the appropriate permissions, you will receive a status 401 error response from the API for "No access permission".
You will need to update the Access Restrictions for your API token, or create a new unique token for that action.
{
"errors": "No access permission"
}
Updated 4 months ago