Before you start

Environments

Kitopay API supports 2 public environments: dev (sandbox) and prod (production). We highly recommend using the sandbox environment for integration and testing and only enabling the production integration after the sandbox sign off.

Sandbox (dev):

https://api.dev.kitopay.com/api

Production:

https://api.kitopay.com/api

API keys

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error.

Your public key (x-merchant-id) is always available in your Dashboard. It looks like this:

dev_pub_fb1dad5f-5982-4e1a-ac2f-62a7daaa7148
prod_pub_fb1dad5f-5982-4e1a-ac2f-62a7daaa7148

The secret key can be retrieved in the dashboard only once. Upon losing access to the secret key, it has to be regenerated and retrieved again through your Dashboard. It looks like this:

dev_sec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
prod_sec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Merchant accounts

Please contact your account manager to set up a merchant account for you for sandbox and production environments. They will create an account for you and give you the access to the Dashboard to your email.

Merchant accounts are organized into merchant groups and merchants. Merchant group can include multiple merchants with different integration types, fee schemes, legal entities, brands, etc. Your account manager will help you with the setup of the accounts.

You will have access to your merchant group account and you will be able to add or remove other team members as well as restrict their access to certain sections and/or certain merchants within the group.