Getting started

Integrating your product with Runa is a simple and straightforward process. To begin, you will need to create an account with us, which will enable you to generate an API key. If you don't have an account yet, you can easily create one by visiting

Creating an API key


Securing your API key

It is extremely important that you keep your API keys safe and secure to avoid any cyber security issues. Keep your keys safe by following these best practices.

Learn more about API key security

Once you have successfully created an account, navigate to the API section within your account dashboard to generate a new API key.

For security reasons, the API key will only be displayed to you at the time of generation. Therefore, it is crucial that you make a note of the API key immediately and store it securely. In the event that you lose the API key, you will need to generate a new one.

Setting up a payment method

When setting up a payment method for your order, you have the option to choose between using your account balance or a saved card.

  1. Account Balance: You can make payment for your order using the balance available in your Runa account. This method allows you to utilize funds already deposited into your account.
  2. Card: Alternatively, you pay for your order using a saved card. If you choose to pay with a Credit Card or Debit Card, dependant on the type of account you have, you may be charged a fee by the payment provider.

Topping up your Account Balance

Once you have accepted our terms and conditions, you have the option to top up your account balance using either a bank transfer or a card payment. Topping up your account balance via bank transfer is free of charge.

To add funds to your account balance through a bank transfer, simply follow the instructions. Please go through the FAQ section on the bank transfer page to know more about this process.

Alternatively, you can choose to top up your account balance using a card payment. However, card payments may be subject to associated fees. These will be indicated during the payment process.

Saving a card to use for payment

If you opt to make payments using a card, you will have to add a card to your account in the Payment Methods section. Any orders made via the API that you would like to pay for using a card will be charged to your saved card. You only need to complete this process once. For added security and to ensure the protection of cardholder data, we utilize Braintree Vault, which offers robust data security features. Braintree Vault employs advanced measures such as multiple encryption keys with split knowledge and dual control to safeguard sensitive card information.


Payment processing fees

If you choose to pay with a Credit Card or Debit Card, dependant on the type of account you have, you may be charged a fee. This fee is reflective of the charges we incur from the payment providers.

If you wish to avoid incurring a card payment fee, you can opt to use our latest API version and make the payment using your account balance.

Having problems integrating?

Let us know what issues your facing and how we can help you get started with the API

Share your feedback

What’s Next

Now, you’re all ready to make your first call! We recommend starting out with a simple order.