Taking payments
Connect Asaas to your app
What is Asaas?
Asaas is a Brazilian company that lets businesses charge customers by Pix, boleto and card, and keeps a digital account for the money.
- What it costs
- No monthly fee and no fee to issue a charge. Asaas lists a fee of R$ 0,99 for each Pix or boleto payment received (shown as a discount from R$ 1,99). Card fees are on the Asaas pricing page. A free test (sandbox) account is available.
- Time needed
- About 10 minutes for a test key. A real account needs Asaas to approve your business first.
- If you skip it
- Your app still works. Only taking Pix, boleto and card payments stays off until you connect it.
What you can build with Asaas
How to get it, step by step
Create your account
- For a free test account, open sandbox.asaas.com and sign up. For real money, sign up at asaas.com instead. The two accounts are separate and have different keys.
Make your API key
- Sign in as the account administrator (only admins can make keys) and open the Integrations area of the Asaas website. The direct page is asaas.com/customerApiAccessToken/index (use sandbox.asaas.com for a test account).
- Create a new API key in the API Keys list, and give it a name you will recognise, such as BooDoo.
- Copy the key before you leave the page. Asaas shows it only once.
Give it to your app
- Paste the key into the box for ASAAS_API_KEY in BooDoo.
Which value goes in which box
- Asaas API key
ASAAS_API_KEYKeep private - On the Asaas website, open the Integrations area and create an API key. A real-money key starts with $aact_prod_ and a test key starts with $aact_hmlg_. It is shown only once, so copy it straight away.
Watch out for
- A test key (starts with $aact_hmlg_) and a real key (starts with $aact_prod_) are different. Use a key only with the matching account.
- The key is secret. Keep it private, like a password, and never put it in a public page.
- A key that goes unused for 3 months is switched off, and after 6 months it expires for good. You would then make a new one.
- If you think someone saw the key, replace it straight away.