How to integrate payments with Asaas?

In this guide we will show you how to integrate your event hosted on MartialMatch with Asaas payment system. This will allow you to accept payments for your event directly through the platform.

Configuration of the Asaas account

You will need to have access to your Asaas account. If you don't have one, you can create it here.

Once you log in you should see a screen like this:

We need to configure two things:

• API Key - This will be used to authenticate your requests to the Asaas API. MartialMatch will use this key to create and request payments from athletes.
• Website - In order to properly create payment link we need to set up the website URL. This will be used to redirect athletes after they complete the payment, back to MartialMatch. It's also a requirement from Asaas to have this set up.

Website

To start configuration, in top right corner click on your profile icon and select Minha conta.

On the next screen, click Informações. You will see a form where you need to fill in your website URL. The field is called Site (Opcional).

Please provide there MartialMatch website URL: https://martialmatch.com/.

After that click Confirmar dados to save the changes.

API Key

Now on the same page there is also a tab available that is called Integração. Click it. You will be moved to the page where you can generate your API Key.

On the next page there will be tab Chaves de API. Click it. You will see a button Gerar chave de API. Click it, and you will be presented with a form where you can generate your API Key.

Please follow the instructions on the page. You will need to provide a name for your API Key, please make it relevant to your MartialMatch account. For example: MartialMatch API Key.

Once the API key is generated. Please keep it, it must be configured in MartialMatch.

MartialMatch configuration

Assuming you have already created your event on MartialMatch, you need to go to the management page of your event. In the top menu click: Event, then Setup pricing.

Click now on Payment gateway configuration. You should see a small dialog:

Click Asaas. After that you will be presented with a form where you need to provide your API Key. Please copy it from Asaas and paste it here. Also, please give your payment gateway configuration a name, so you can easily identify it later. For example: Asaas.

After you fill in the form:

1. Click Check connection, the system will check if the API key is valid and if the connection to Asaas is working.
2. Click Save to save the configuration.

ℹ️ MartialMatch encrypts your API key and stores it in a secure way. We do not store it in plain text, so you can be sure that your API key is safe.

Now, you will be able to define pricing for your event. For details please follow this tutorial (Eng).