> For the complete documentation index, see [llms.txt](https://ajuda.uplaces.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.uplaces.com.br/integracoes/asaas.md).

# Integração com o Asaas

Integração Asaas na Uplaces: Pix, boleto e cartão no pedido B2B, com link de pagamento e baixa automática. Cadastre a Chave de API, o webhook e a política.

Com o Asaas conectado, o comprador fecha o pedido na loja B2B e paga pela fatura do Asaas, por Pix, boleto ou cartão. Quando o pagamento é aprovado, o pedido muda de status sozinho, e você não precisa conferir extrato para liberar a mercadoria.

O Asaas é uma conta digital com cobrança por Pix, boleto e cartão. A Uplaces usa a sua conta do Asaas para gerar a cobrança de cada pedido e é avisada quando o pagamento cai. Você escolhe quais formas de pagamento oferecer, com parcelas, desconto à vista e pedido mínimo, e quais clientes as veem.

## Antes de começar

* Quem pode: o administrador da loja.
* Conta ativa no Asaas e a **Chave de API** dela. No Asaas, a chave fica na área de integrações; consulte a [documentação do Asaas](https://docs.asaas.com).
* O módulo **Meios de pagamento** ligado em **Módulos**.

{% stepper %}
{% step %}

## Cadastrar o provedor

1. Abra **Meios de pagamento › Provedores**, clique em **Incluir** e escolha **ASAAS**.
2. Em **Nome**, informe um nome para você reconhecer, por exemplo Pagamento Asaas.
3. Em **Chave de API**, cole a chave e clique em **Testar conexão**. Se der certo, a tela mostra o nome da empresa cadastrada no Asaas.
4. Em **Atualizar status do pedido quando o pagamento for aprovado**, escolha o status, por exemplo **Recebido pelo fornecedor**.
5. Em **Status**, escolha **Homologação** para testar com a chave de teste do Asaas, ou **Produção** para receber de verdade.
6. Clique em **Salvar**. As abas **Financeiro** e **Webhook** ficam disponíveis depois de salvar.

Trate a **Chave de API** como uma senha: não envie por e-mail nem por mensagem.
{% endstep %}

{% step %}

## Ativar as formas de pagamento

Na aba **Financeiro** estão **Cartão de Crédito**, **Boleto Bancário** e **PIX**. Todas começam desligadas. Para cada uma que você quer oferecer:

1. Clique em editar e mude o **Status** para **Ativo**.
2. Em **Parcelar as compras em até**, escolha ao menos **1x**, inclusive para Pix e boleto à vista. Sem isso, a forma não aparece no checkout.
3. Se quiser, preencha as condições: **Desconto à vista (%)**, **Pedido mínimo (R$)** e **Pedido máximo (R$)**, parcelas e juros.
4. Salve.

| Para                                   | Use                                                                    |
| -------------------------------------- | ---------------------------------------------------------------------- |
| dar desconto no Pix                    | **Desconto à vista (%)** no PIX                                        |
| parcelar no cartão                     | **Parcelar as compras em até** e **Valor mínimo de cada parcela (R$)** |
| cobrar juros a partir de certa parcela | **Juros a partir da parcela** e **Juros por mês (%)**                  |
| oferecer boleto só em pedido maior     | **Pedido mínimo (R$)** no boleto                                       |
| {% endstep %}                          |                                                                        |

{% step %}

## Criar o webhook no Asaas

O webhook é o aviso que o Asaas manda à Uplaces quando um pagamento muda de situação. É ele que muda o status do pedido sozinho.

1. Na aba **Webhook** do provedor, copie o endereço que aparece.
2. No Asaas, crie um webhook com esse endereço. A documentação explica o passo: [webhooks do Asaas](https://docs.asaas.com/docs/webhooks).
3. Salve o webhook no Asaas.
   {% endstep %}

{% step %}

## Ligar à política comercial

1. Abra a política comercial dos clientes e a aba **Pagamento**.
2. Na seção **Pagamento online**, escolha o provedor no campo **Asaas**.
3. Salve.

Os clientes dessa política passam a ver no checkout as formas que estão **Ativas** na aba **Financeiro**. Veja [Formas de pagamento na política](https://ajuda.uplaces.com.br/ecommerce-b2b/politicas-comerciais/formas-de-pagamento-nas-politicas-comerciais.md).
{% endstep %}
{% endstepper %}

## O que o comprador vê

1. No checkout, as formas ativas: Pix, boleto e cartão, com as parcelas e os descontos que você configurou.
2. Ao finalizar, o **Link de pagamento** com o botão **Acessar Fatura**, que abre a fatura do Asaas.
3. Na fatura, ele paga pela forma escolhida.

Quando o Asaas confirma o pagamento, o pedido muda para o status escolhido no cadastro do provedor, e o pagamento aparece como **Aprovada**. Com o ERP integrado, o novo status segue para o ERP conforme a [integração com o ERP](https://ajuda.uplaces.com.br/integracoes/integracao-com-erp.md). Cada aviso do Asaas fica no [Log de integração](https://ajuda.uplaces.com.br/integracoes/log-de-integracao.md), na aba **Recebidos**.

{% hint style="info" %}
Estorno e cancelamento no Asaas não mudam o status do pedido sozinhos: ficam registrados, e você decide o que fazer com o pedido.
{% endhint %}

## Problemas comuns

<details>

<summary>O comprador não vê Pix, boleto ou cartão</summary>

Confira, nesta ordem: a forma está **Ativa** na aba **Financeiro**; **Parcelar as compras em até** tem ao menos **1x**; o valor do pedido está entre o **Pedido mínimo** e o **Pedido máximo**; e a política comercial do cliente tem o provedor no campo **Asaas**. Quando nada se encaixa, o checkout avisa que nenhuma condição de pagamento foi encontrada.

</details>

<details>

<summary>O pagamento foi aprovado e o pedido não mudou de status</summary>

Confira se o webhook do Asaas usa o endereço da aba **Webhook** e se **Atualizar status do pedido quando o pagamento for aprovado** não está em **Não atualizar o status do pedido**. No [Log de integração](https://ajuda.uplaces.com.br/integracoes/log-de-integracao.md), procure o aviso do pagamento: sem aviso, o problema está no webhook do Asaas. Se o endereço da aba **Webhook** mudou, atualize o webhook no Asaas.

</details>

<details>

<summary>Testar conexão diz que a chave foi recusada</summary>

A chave foi apagada, desativada ou expirou no Asaas. Chave sem uso por alguns meses é desativada pelo próprio Asaas. Gere uma nova no Asaas e cole em **Chave de API**. Chave de teste só funciona com o status **Homologação**.

</details>

<details>

<summary>O checkout diz que o pagamento online está indisponível</summary>

O Asaas recusou a chave na hora de gerar a cobrança. Nesse caso, o painel mostra o alerta **Seus clientes não conseguem pagar online** e avisa os administradores por e-mail. Clique em **Atualizar a chave do Asaas**, use **Testar conexão** no cadastro do provedor e, se preciso, troque a chave. O alerta some na próxima cobrança online que o Asaas aceitar. Enquanto isso, o comprador pode escolher outra forma de pagamento. Veja [Alertas da conta](https://ajuda.uplaces.com.br/primeiros-passos.md#alertas-da-conta).

</details>

## Perguntas frequentes

<details>

<summary>O Asaas aceita Pix, boleto e cartão na Uplaces?</summary>

Sim. O comprador vê as formas que você deixou **Ativas** na aba **Financeiro** do provedor.

</details>

<details>

<summary>O Asaas gera link de pagamento do pedido?</summary>

Sim. Ao finalizar o pedido, o comprador recebe o **Link de pagamento** com o botão **Acessar Fatura**, e paga a fatura do Asaas.

</details>

<details>

<summary>Posso testar sem cobrar de verdade?</summary>

Sim. Use o status **Homologação** com a chave de teste do Asaas. Quando for receber de verdade, troque para **Produção** com a chave de produção.

</details>

<details>

<summary>Posso oferecer o pagamento online só para alguns clientes?</summary>

Sim. O checkout mostra o Asaas para os clientes da política comercial que tem o provedor no campo **Asaas**, na aba **Pagamento**. Os clientes de uma política com o campo vazio seguem com as condições de pagamento dela.

</details>

<details>

<summary>Uso o Tiny. O meio de pagamento vai para o pedido no ERP?</summary>

Sim. Com o Tiny, o cadastro do provedor mostra o campo **Nome do Gateway**, que segue com o pedido para o Tiny.

</details>

## Veja também

* [Meios de pagamento](https://ajuda.uplaces.com.br/meios-de-pagamento.md)
* [Pix com QR Code](https://ajuda.uplaces.com.br/meios-de-pagamento/pix.md): Pix pela chave, sem conta em outro serviço
* [Formas de pagamento na política](https://ajuda.uplaces.com.br/ecommerce-b2b/politicas-comerciais/formas-de-pagamento-nas-politicas-comerciais.md)
* [Condições de pagamento](https://ajuda.uplaces.com.br/ecommerce-b2b/politicas-comerciais/condicoes-de-pagamento.md)
