Setting up a Sandbox Account

First of all you need to create a free sandbox account in order to move on this tutorial. When it's done you can follow these steps to get your account up and running with ease.

Create an API key

To get started with the API, you will need an API key, which you can create from Developers > API Keys.

Create the API key with custom name. If you plan to use multiple API keys, make sure you use affordable names according with team or responsibility.

The API key is shown to you after you submit the form. Copy it somewhere secure, as each key is only ever shown to you once in the Trio console. After that, mark the confirm checkbox and it's done.


Keep it safe!

Make sure you keep your API keys private. Never save API keys in your code or in Github. Instead use environment files and, for an extra level of security, rotate API keys regularly.

Register a new webhook

With webhooks you'll be able to receive real-time notifications of your account transactions, which you can create from Developers > Webhooks.

When creating a webhook, inform the URL and a secret. The webhook URL needs to be able receive a POST in order to complete the request. More details about how we manage and send webhooks here.

Following logs and webhook events

As developers we understand how important is to have tools to help debug to solve problems and bugs. With that in mind we release two powerful tools that will help during the integration and production.


You can access the Logs from Developers > Logs and have access to all information around the process from a every API request. It's important to keep the header x-request-id, so with that in hand it's super simple to filter and find a request at the console.

Webhook Events

For every webhook we sent to you we keep a copy to give you the assurance that information was processed or even help you to reprocess that information. You can access events from Developers > Events.

Step by step tutorial