# Integração com Asaas

> Conecte sua conta Asaas para receber Pix, cartão de crédito e boleto na sua loja.

Fonte: https://ajuda.stoqui.com.br/integracao-com-asaas
Atualizado em: 2026-04-29

O **Asaas** é um meio de pagamento que permite receber **Pix, cartão de crédito (com parcelamento até 12x) e boleto** direto na sua conta Asaas. A integração é feita por uma chave de API — o dinheiro vai direto para sua conta Asaas, sem passar pelo Stoqui.

## Pré-requisitos

- **Conta no Asaas.** Se ainda não tem, crie em [asaas.com](https://www.asaas.com).
- **A chave de API NÃO pode ter permissão de saque.** Você gera a chave somente com permissão para criar cobranças, conforme o passo a passo abaixo.

## Passo a Passo

### 1. Abrir a tela do Asaas no Stoqui

No app Stoqui, vá em **Geral › Meios de pagamento** e selecione **Asaas**.

### 2. Gerar a chave de API no Asaas

Em outra aba do navegador, acesse [asaas.com](https://www.asaas.com) e faça login. Depois:

1. Vá em **Minha Conta › Integrações › Chaves de API**.
2. Clique em **Gerar chave de API**.
3. No campo **Nome**, coloque "Stoqui".
4. **NÃO** marque o checkbox de *"Permitir que esta chave execute operações de saque via API"*.
5. **NÃO** preencha os campos de "Data de expiração" e "Hora de expiração".
6. Copie a chave gerada (começa com `$aact_...`).

### 3. Conectar sua conta no Stoqui

Volte ao app Stoqui e cole a chave no campo **API Key do Asaas**. Clique em **Conectar conta**.

Pronto — sua conta Asaas está conectada à loja.

## Definir o Asaas como padrão

Após conectar, na mesma tela do Asaas, na seção **Padrão no checkout**, você pode escolher:

- **Pix via Asaas** — quando ativado, o Pix do checkout passa pela conta Asaas (com confirmação automática).
- **Cartão de crédito via Asaas** — quando ativado, os pagamentos com cartão passam pelo Asaas.

Esses dois switches são exclusivos com o Mercado Pago: ativar um desativa o equivalente do outro provedor.

## Como o cliente paga

O pagamento acontece direto na sua loja, **sem redirecionar para o site do Asaas**. Na última etapa do checkout, o cliente vê o **QR Code do Pix** e o **formulário de cartão de crédito** dentro da própria página do Stoqui. Para o cliente, é como qualquer outro processador de pagamentos — ele paga e a confirmação é automática.

Os pagamentos confirmados atualizam o status do pedido no Stoqui automaticamente.

## Onde acompanhar o dinheiro

O Stoqui não exibe saldo, transferências, antecipações ou extratos do Asaas. Para essas operações, use o painel do próprio Asaas:

- **Botão "Acessar painel do Asaas"** na tela do Asaas no Stoqui, ou direto em [asaas.com/dashboard](https://www.asaas.com/dashboard/home).

## Configurações adicionais

- **Parcelamento, desconto Pix e mais** — ajuste em [Configurações do checkout](/configuracoes-do-checkout).
- **Taxas** — quem cobra é o Asaas, conforme seu plano com eles. O Stoqui não cobra taxa adicional.

## Ativar / desativar / desconectar

- **Ativar/desativar sem desconectar** — use o seletor (switch) no topo da tela quando a conta estiver conectada. Ideal para pausar pagamentos temporariamente.
- **Desconectar** — abra o menu de **3 pontinhos** no canto superior direito da tela e clique em **Desconectar**. Seus clientes deixam de pagar via Asaas até você reconectar.

## Migrando do Stoqui Pay?

Se você usava o **Stoqui Pay**, o Asaas já era a fintech parceira por trás dele. Migrar para o Asaas direto é a evolução natural — você passa a ter conta própria no Asaas, com saques, antecipações e relatórios direto no painel deles.