Integração com Asaas

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.
• 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 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.

Configurações adicionais

• Parcelamento, desconto Pix e mais — ajuste em Configurações 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.