Receber Pix e cartão online com o ASAAS

A loja pode receber o pagamento online pelo ASAAS, no lugar do Mercado Pago ou da InfinitePay. O dinheiro cai direto na sua conta — a AgoraFood não recebe, não retém e não repassa — e a loja recebe por um gateway de cada vez: conectar o ASAAS guarda o gateway que estava em uso.

Onde achar a chave de API

No painel do ASAAS, abra Integrações → Chaves de API e gere (ou copie) a chave da sua conta. Ela começa com $aact_. A chave é como uma senha da conta: cole no AgoraFood e não envie a ninguém.

Conta de produção

Use a chave da sua conta de produção. A chave do ambiente de testes do ASAAS (o sandbox) é recusada, com o aviso “Esta é uma chave de API do sandbox do ASAAS”.

Conectar

1. No painel, em Integrações → Gateways de pagamento, clique em Conectar ASAAS. Na janela que abre, cole a chave de API e clique em Conectar ASAAS.

2. O AgoraFood confere a chave com o ASAAS e ativa sozinho o aviso de pagamento (o webhook) na sua conta — você não precisa configurar nada no ASAAS. Ele aparece lá, em Integrações → Webhooks, com o nome AgoraFood. Não apague esse aviso: é por ele que o pedido fica pago na hora.

3. Pronto: o ASAAS passa a ser o gateway da loja, e o cartão mostra Conectado. Se outro gateway estava conectado, ele fica Guardado: não cobra pedidos novos, mas continua devolvendo e confirmando o que já recebeu.

Se a chave estiver errada, sem permissão ou se o ASAAS não aceitar o aviso, a janela mostra o motivo e nada muda — o gateway atual continua recebendo.

O que o cliente vê

No checkout, aparece uma forma online: Pagamento online. Depois de fazer o pedido, o cliente toca em Ir para o pagamento e é levado à página do ASAAS, onde escolhe entre as formas que você ligou — Pix, cartão de crédito ou as duas —, informa os dados dele e paga. Volta para o pedido, que mostra Confirmando o pagamento por alguns segundos e depois Pagamento confirmado.

O cartão é digitado na página do ASAAS, e não na loja: nenhum dado de cartão passa pelo AgoraFood. O AgoraFood grava sozinho como o cliente pagou — Pix ou crédito — e é isso que aparece no caixa e nos relatórios. Veja Pagamento online.

Cobrar no PDV e no delivery

No pedido lançado no PDV ou no delivery, Gerar link de pagamento cria um link do ASAAS para o valor do pedido, válido pelo prazo das Configurações avançadas de cobrança. Copie o link ou envie pelo WhatsApp do cliente; quando ele pagar, o pedido fica pago sozinho. Com o ASAAS não há Gerar Pix: o Pix é escolhido pelo cliente na página do link.

Escolher as formas que você aceita

No cartão do ASAAS, em Integrações, cada forma tem o seu interruptor:

• Pix e Cartão de crédito se ligam e desligam separados. A página do ASAAS mostra ao cliente só as formas ligadas: com o crédito desligado, por exemplo, ela abre só com o Pix — no pedido da vitrine e no link gerado no PDV.
• Cartão de débito aparece desligado e travado, com o aviso “O ASAAS não oferece cartão de débito na página de pagamento”. A página de pagamento do ASAAS só tem Pix e crédito.

No checkout da loja nada muda: o cliente continua vendo uma forma, Pagamento online, e escolhe entre as formas ligadas na página do ASAAS. Com as duas desligadas, a vitrine deixa de oferecer o pagamento online, e o cliente vê só as formas combinadas com a loja.

As parcelas e o repasse de juros do cartão se configuram no app do ASAAS.

A taxa

O AgoraFood lê do ASAAS quanto ele reteve de cada pagamento, e o financeiro mostra a taxa e o líquido de cada pedido sem você informar nada.

Cancelar e devolver

Ao cancelar um pedido pago pelo ASAAS, ou remover um item, a devolução é pedida ao ASAAS sozinha — o valor inteiro ou só o do item. Mas o ASAAS só devolve depois da sua autorização:

1. No app ou no painel do ASAAS, autorize a devolução pendente (o ASAAS chama de autorização de ação crítica, e pede o código que ele envia a você).

2. Autorizada, o valor volta para o cliente, e o pedido mostra o estorno como concluído. Você não precisa confirmar nada no AgoraFood.

Devolução sem autorizar uma a uma

O ASAAS permite liberar as ações feitas pela API, nas configurações de segurança da conta. Isso é uma decisão da sua conta, e vale para tudo o que é feito por chave de API — leia as orientações do ASAAS antes de mudar.

Se o pedido for cancelado duas vezes, ou a devolução for tentada de novo, o AgoraFood não pede uma segunda devolução: cada valor é pedido uma vez só.

A autorização vale para o cartão e para o Pix: o estorno de Pix também sai pela API e espera você autorizar no ASAAS. Enquanto isso, a linha do item — e a seção Estornos do pedido — mostram “Estorno solicitado ao ASAAS — autorize no app do ASAAS”. Autorizado, o selo vira Estornado sozinho; se você negar no ASAAS, ele vira Devolução manual pendente, para você devolver por lá e confirmar em Já devolvi. Veja Onde ver o estorno de cada item.

Item removido no mesmo dia de uma venda no cartão

O ASAAS só devolve parte de uma venda no cartão a partir do dia seguinte. Por isso, quando você remove um item de um pedido pago no cartão no mesmo dia, o estorno do item fica agendado:

• o pedido mostra, no painel, Estorno agendado com o valor e a hora — por exemplo, “Estorno de R$ 27,90 agendado para 04/10 às 12:30”. A hora é 24 horas depois do pagamento;
• o cliente vê, na página do pedido, “O estorno de R$ 27,90 está previsto para 04/10.”;
• na hora prevista, o AgoraFood pede o estorno ao ASAAS sozinho — você não precisa fazer nada além de autorizá-lo no app do ASAAS, como qualquer outra devolução.

Se o ASAAS ainda não aceitar, o AgoraFood tenta de novo de hora em hora, por 12 horas. Se mesmo assim não sair, o pedido passa a mostrar Devolução pendente: aí a devolução é sua, pelo painel do ASAAS, e você confirma em Já devolvi. O valor nunca fica esquecido.

O cancelamento do pedido inteiro não espera: o ASAAS devolve a venda inteira no mesmo dia.

Trocar a chave ou desconectar

Trocar a chave, no cartão do ASAAS, recebe uma chave nova e renova o aviso de pagamento. Use quando gerar outra chave no ASAAS. Se o ASAAS recusar a chave em uso, o cartão mostra Colar a chave de novo, e os pagamentos online ficam parados até lá.

Desconectar remove o aviso de pagamento da sua conta ASAAS e apaga a chave do AgoraFood. A chave continua valendo no ASAAS até você revogá-la por lá.

Trocar de gateway

No cartão do gateway guardado, Usar este gateway faz dele o que recebe os pedidos, e o outro fica guardado. Nada se perde: cada pagamento continua ligado à conta que o recebeu, e a devolução de um pedido antigo sai pela conta que o cobrou.

Na marca

A marca também pode conectar o ASAAS em Integrações da marca, com a chave da conta da rede. As unidades sem conta própria passam a receber por ela. A unidade que conectar o próprio gateway recebe só por ele.