Support channels

Having an issue or a question about your integration?

Contact us

For technical questions about integrations with Asaas, contact the Integration Success team:

This is the official channel for error analysis, flow validation, and questions related to the API, Webhooks, Sandbox, and official plugins.

📘

Support hours

Integration support is provided on business days, from 8 a.m. to 7 p.m. (Brasília time)

The typical response time during business hours is up to 2 hours.

When to contact us

Reach out to integration support when you need to:

  • clarify questions about endpoints, parameters, responses, or errors;
  • analyze unexpected API behavior;
  • validate payloads and integration flows;
  • investigate issues with authentication, permissions, or environments;
  • understand Webhook behavior;
  • get help with testing in the Sandbox;
  • clarify questions about official plugins.

For commercial questions, feature enablement, or account-related matters, talk to your account manager via WhatsApp at 0800 009 0037.

If you don't have an account manager, send an email to [email protected].

Before contacting support

Before reaching out:

  • confirm that you are using the correct environment;
  • check that the API Key belongs to the environment being used;
  • double-check the endpoint, HTTP method, and headers;
  • review the payload format;
  • consult the documentation for the resource;
  • test the request again using Postman or Insomnia;
  • gather the IDs, timestamps, and error messages related to the case.

This information helps reduce investigation time.

Required information

Whenever possible, send:

InformationExample
EnvironmentSandbox or Production
Resource or endpoint/v3/payments, Webhooks, or Checkout
HTTP methodGET, POST, PUT, or DELETE
Date and timeDate, time, and time zone
HTTP code400, 401, 403, 404, 429, or 500
Error messageResponse returned by the API
Resource IDpay_..., cus_..., or sub_...
Payload sentWith sensitive data masked
Response receivedWith sensitive data masked
Expected resultWhat should have happened
Observed resultWhat actually happened
🚧

Protect your credentials

Never send API Keys, tokens, passwords, full card data, or other credentials by email, Discord, or WhatsApp.

Remove or mask sensitive data before sharing payloads, responses, or images.

Message template

Use the template below to send the case information:

Hello, team!

We need help with the flow below:

Environment:
Resource or endpoint:
HTTP method:
Approximate date and time:
HTTP code returned:
Error message:
Resource ID:
Expected result:
Observed result:

Payload sent:
Response received:

Sensitive data has been removed or masked.

Other channels

ChannelWhen to use
Integration SuccessTechnical integration questions and analyses
DiscordCommunity, exchanging experiences, and general questions
WhatsApp 0800 009 0037Commercial questions, feature enablement, and contact with your account manager

Discord

Discord is a community channel and does not replace official technical support.

Use it to:

  • exchange experiences with other developers;
  • follow community discussions;
  • share general questions;
  • look up examples and best practices.

For cases that require investigation, account validation, or formal follow-up, send an email to the Integration Success team.


Account manager

For commercial questions, feature enablement, or account-related conditions, contact us via WhatsApp:

0800 009 0037

The account manager WhatsApp is available 24 hours a day for commercial and account-related questions. Technical integration questions follow the support hours above.


Best practices for critical flows

Implement logging, monitoring, alerts, and safe retries in your application.

Support can help with investigations, but your integration must be prepared to handle temporary failures, unexpected responses, and reprocessing.


Did this page help you?