Introduction - Guru

Connect your Asaas account to Checkout Guru to process sales via Pix, bank slip (boleto), and credit card, as well as to operate one-time sales, subscriptions, and Payment Split.

Before you begin

Have:

• an active Asaas account;
• a Digital Manager Guru account;
• an Asaas Production API Key;
• administrative access to Guru;
• the payment methods you intend to offer defined.

Products and offers can be registered after the integration is active.

How it works

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Create Production API Key"] --> B["Connect Asaas to Guru"]
    B --> C["Configure the integration"]
    C --> D["Register products and offers"]
    D --> E["Link the offer to Asaas"]
    E --> F["Generate the checkout"]
    F --> G["Make a test sale"]
    G --> H["Operate sales and subscriptions"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px

    class A inicio
    class B,C,D,E,F,G validacao
    class H sucesso

    linkStyle default stroke:#94A3B8,stroke-width:2px

1. Create the API Key in Asaas

The integration uses a Production API Key.

In the Asaas web interface, go to Integrations > API Keys and create a new key.

The key is displayed only once. Copy and store the credential before leaving the page.

See how to create and manage API Keys.

2. Activate Asaas in Guru

In the Guru admin, go to:

Configurações > Integrações > Checkout Guru > Asaas (Settings > Integrations > Checkout Guru > Asaas)

Enter the API Key and review the available settings:

Then:

1. activate the integration;
2. click Enviar (Submit).

Expected result

After saving, the Asaas account details should appear in the integration details area in Guru.

If this does not happen, review the API Key and confirm that the integration is active.

3. Register products and offers

With Asaas connected, configure the products and offers that will use this processor.

For each offer, define according to your operation:

• one-time or recurring sale;
• Pix, bank slip (boleto), or credit card;
• number of installments;
• discounts for upfront payment;
• link between the offer and Asaas.

Then generate the checkout link.

4. Configure the Split, if needed

The integration allows you to distribute amounts among sale participants, such as affiliates and co-producers.

The configuration of recipients and commissions is managed in Guru.

To understand the financial rules applied by Asaas, see Payment Split.

5. Validate the checkout

Before sharing the link:

1. confirm that the offer uses Asaas;
2. review the payment methods;
3. validate installments and discounts;
4. check the Pix and bank slip deadlines;
5. validate the commission rules, when there is a Split;
6. make a controlled test sale;
7. confirm that the payment was recorded in the expected Asaas account.

Expected result

Checkout Guru should display the conditions configured in the offer, and payments should be processed by the Asaas account linked to the integration.

Common errors

API Key rejected

Check that:

• the key was copied in full;
• the key is still active;
• the credential belongs to the expected Production account.

Integration configured but inactive

Confirm that the Ativo (Active) option is enabled and that the configuration was submitted.

Offer does not use Asaas

Review the link between the product or offer and the payment processor before sharing the checkout.

Pix or bank slip with a different due date than expected

Review the Prazo do Pix (Pix deadline) and Prazo do boleto (Bank slip deadline) fields in the integration configuration.

Payment method or installments do not appear

Review the conditions configured in the product offer.

Next steps

• Manage your API keys
• Learn the Payment Split rules
• Go back to the Digital Manager Guru overview

For questions about Guru-specific settings, contact Digital Manager Guru support.