# Conectar o Asaas

Aceite cartão (e PIX pelo checkout) com sua conta Asaas.

Fonte: https://docs.altaris.love/artigo/asaas/

Com o Asaas conectado, o convidado paga o presente numa página segura do próprio Asaas — cartão e, se a conta de vocês tiver chave PIX cadastrada lá, PIX também. O valor entra na **conta Asaas de vocês**.

> Gateways de cartão fazem parte dos planos com essa opção — [confira o seu](https://docs.altaris.love/artigo/planos-e-cupons/). O [QR code PIX direto](https://docs.altaris.love/artigo/pix-estatico/) é livre em todos.

## Antes de começar

Vocês precisam de uma conta [Asaas](https://www.asaas.com) com o cadastro aprovado (o Asaas pede documentos na abertura).

## Pegando a chave de API

O Asaas não tem o botão de "conectar em um clique" que o [Mercado Pago](https://docs.altaris.love/artigo/mercado-pago/) e o [PagBank](https://docs.altaris.love/artigo/pagbank/) têm — lá a chave é copiada à mão. Mas o painel mostra o passo a passo com atalho direto para cada tela:

1. Entrem no site do Asaas **pelo computador** e com um usuário **administrador** (o aplicativo não gera chave de API);
2. Acessem **Integrações → Chaves de API** e gerem uma chave;
3. Copiem a chave — ela aparece **uma única vez**. A de produção começa com `$aact_prod_` (a de testes, `$aact_hmlg_`, não recebe dinheiro de verdade, e o painel avisa se ela for colada por engano).

## Conectando no Altaris

1. **Painel → Pagamentos → Conectar** no cartão do Asaas;
2. Colem a chave de API e salvem;
3. Nós validamos a chave e **registramos automaticamente** o aviso de pagamento na conta de vocês — nenhum passo extra no Asaas.

A credencial fica guardada **criptografada** e nunca aparece de novo no painel.

## Detalhe do PIX no checkout Asaas

O checkout do Asaas só oferece PIX se a conta Asaas de vocês tiver uma **chave PIX cadastrada lá dentro**. Sem chave, o checkout mostra só cartão — o QR code PIX [do nosso fluxo direto](https://docs.altaris.love/artigo/pix-estatico/) continua funcionando normalmente, são caminhos independentes.

## Quem paga a taxa do cartão

Vocês escolhem, em **Painel → Pagamentos → Credenciais** (no cartão do Asaas), no campo **Quem paga a taxa do cartão**. O campo da chave de API pode ficar em branco ao salvar: a que já está salva continua valendo.

- **Vocês pagam as taxas**: o convidado paga o preço do presente, em qualquer forma.
- **O convidado paga o acréscimo do parcelado**: à vista, o preço do presente; no parcelado, o total cresce só o suficiente para vocês receberem o mesmo que receberiam à vista.
- **O convidado paga a taxa do cartão**: no cartão, à vista ou parcelado, o total inclui toda a taxa do Asaas, e vocês recebem o valor cheio do presente.

Nas três, o **PIX** sai pelo preço do presente. Quando o cartão leva alguma taxa, o convidado escolhe a forma e as parcelas no site antes de ir para o Asaas, e já vê o total de cada opção.

## Parcelamento no cartão

O cartão começa à vista. Para liberar o parcelado, no mesmo lugar, escolham em **Parcelamento no cartão** até quantas vezes (de 2 a 12) e salvem.

- Cada parcela tem no mínimo R$ 5, então presente de valor baixo aparece com menos opções (um de R$ 20 vai até 4x).
- O dinheiro do parcelado entra uma parcela por mês; antecipar, se quiserem, é pela conta Asaas de vocês, com a taxa de lá.
- Quem escolhe parcelar e desiste no meio deixa uma cobrança na conta Asaas de vocês; nós a apagamos sozinhos em menos de uma hora.

## Como os pagamentos chegam

O Asaas nos avisa a cada pagamento e o presente é marcado como recebido sozinho (**Painel → Pagamentos**); o convidado recebe e-mail de confirmação. Prazos e taxas de recebimento são os da conta Asaas de vocês.

## Problemas comuns

- **Chave recusada**: confiram se copiaram a chave inteira (é longa) e se a conta já está aprovada pelo Asaas.
- **"Não aparece PIX no checkout"**: é a chave PIX faltando NA CONTA ASAAS (explicado acima) — não é defeito da conexão.