Helcim

Setting up Helcim

1. 1

   Log in to your Helcim account, or your Helcim developer test account

2. 2

   Click All Tools in the top-left corner

3. 3

   Select Integrations under Merchant Tools

4. 4

   Make sure you're on the API Access Configurations page

5. 5

   Click New API Access

6. 6

   Enter a name for the configuration, such as "Foxy.io"

7. 7

   Do not check the "I will use this token for a checkout integration" checkbox. That option is for HelcimPay.js, which Foxy doesn't use

8. 8

   Under Access Restrictions, set Transaction Processing to Admin. General and Settings can be left as Read

9. 9

   Click Create in the top right to save the configuration and generate your token

10. 10

    In the API Access Information section, copy the Token value. This is the only value you need for Foxy

11. 11

    Go to the Foxy admin and go to Settings > Payments

12. 12

    Open or create a payment method set, then click Add payment method + and choose Helcim

13. 13

    Enter your API token

14. 14

    Optionally set Card verification to verify a card is valid without charging it. We generally recommend Enabled, automatically

15. 15

    Enter your Terminal ID from Helcim if needed

16. 16

    Save your payment settings

Important: request full card numbers for your Helcim account

Before you can take payments, contact Helcim support and request that your account be enabled for using full card numbers with their API. Helcim will reach out to us to confirm you're a Foxy.io user before enabling it. They may also ask you for PCI compliance documentation, though Foxy handles the card data processing itself.

Testing

Contact Helcim for test account details and test card numbers.

Troubleshooting & interpreting response codes

See Helcim's support documentation on gateway API response variables for help interpreting payment response codes.