Pix automático com Asaas na Tiendli Brasil
Com o Asaas Pix, o comprador escolhe Pix na loja, informa o CPF/CNPJ, recebe um QR Code dinâmico e pode pagar pelo aplicativo de qualquer banco. A Tiendli confirma o pagamento depois de verificar a cobrança na API do Asaas.
1. Antes de começar
- Crie sua loja gratuita na Tiendli Brasil e publique seus produtos com preços em BRL.
- Abra sua própria conta Asaas e obtenha aprovação e acesso à API. O dinheiro entra nessa conta, não na conta da Tiendli.
- Prepare uma conta sandbox no Asaas para testar sem dinheiro real. Credenciais de sandbox e produção são diferentes.
- Confira as tarifas do Asaas e as condições do plano Tiendli. Pix direto manual continua disponível como alternativa.
2. Configurar no painel
- Entre em Negócio → Meios de pagamento → Pix automático — Asaas Brasil.
- Marque Ambiente de testes e cole sua API Key de sandbox.
- Gere um token forte e exclusivo de 32 a 255 caracteres para o webhook; nunca use a API Key como token.
- Copie a URL de webhook exibida pela Tiendli e configure-a no painel de Integrações do Asaas, utilizando a mesma autenticação.
- Assine os eventos PAYMENT_RECEIVED, PAYMENT_CONFIRMED e PAYMENT_REFUNDED, com API v3. Salve e selecione Testar conexão.
- Após validação técnica e liberação da Tiendli, altere para produção, insira as novas credenciais, configure o webhook produtivo e habilite o checkout.
A fase inicial permanece bloqueada para cobranças reais até concluir testes de integração e habilitar a funcionalidade pela plataforma. Nunca use credenciais de produção para uma simulação.
3. Como funciona a compra
O cliente informa nome, e-mail e CPF/CNPJ válido, confirma o pedido e recebe um QR Code Pix dinâmico e o código Pix copia e cola. O pagamento pode ser realizado por bancos como Itaú ou Nubank, mesmo que a conta recebedora seja Asaas. A Tiendli consulta a cobrança e só libera o pedido após o status RECEIVED ser validado, com o valor e a referência corretos.
O sistema evita confirmações repetidas em caso de múltiplos webhooks. Eventos incompletos ou incompatíveis não autorizam a entrega.
4. Posso trocar o banco ou o meio de recebimento?
Sim. Os produtos, preços e fotos permanecem na sua loja. Você pode desativar o Asaas e ativar Mercado Pago ou Pix direto na chave do Itaú/Nubank sem recriar o catálogo. Cobranças pendentes devem ser conciliadas antes de substituir credenciais. Pix direto exige conferência manual; Mercado Pago e Asaas usam seus próprios sistemas para pagamentos automáticos.
5. Custos, segurança e suporte
A loja pode começar no plano Gratuito, com até 50 produtos. As tarifas do Asaas são cobradas conforme seu contrato e as eventuais comissões Tiendli seguem as condições do plano e do fluxo de pagamento. Confirme os valores antes de ativar a função.
Nunca envie API Keys ou tokens por WhatsApp. Se houver falha, informe ao suporte o número do pedido, a data e a mensagem exibida, sem compartilhar segredos ou dados completos de cartão.
Documentação oficial: Cobranças Pix do Asaas e Webhooks Asaas.