← Voltar ao guia de Pix

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

  1. Crie sua loja gratuita na Tiendli Brasil e publique seus produtos com preços em BRL.
  2. Abra sua própria conta Asaas e obtenha aprovação e acesso à API. O dinheiro entra nessa conta, não na conta da Tiendli.
  3. Prepare uma conta sandbox no Asaas para testar sem dinheiro real. Credenciais de sandbox e produção são diferentes.
  4. Confira as tarifas do Asaas e as condições do plano Tiendli. Pix direto manual continua disponível como alternativa.

2. Configurar no painel

  1. Entre em Negócio → Meios de pagamento → Pix automático — Asaas Brasil.
  2. Marque Ambiente de testes e cole sua API Key de sandbox.
  3. Gere um token forte e exclusivo de 32 a 255 caracteres para o webhook; nunca use a API Key como token.
  4. Copie a URL de webhook exibida pela Tiendli e configure-a no painel de Integrações do Asaas, utilizando a mesma autenticação.
  5. Assine os eventos PAYMENT_RECEIVED, PAYMENT_CONFIRMED e PAYMENT_REFUNDED, com API v3. Salve e selecione Testar conexão.
  6. 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.