Passo 1. Obtenha o login e o segredo
Crie uma chave secreta no painel da UTOPAY (Integration → API keys); comece com uma chave de teste utopay_sk_test_…. Cole aqui — a chave é enviada só para api.utopay.app e não fica salva nesta página.
Uma chave de teste gera configurações de sandbox; uma chave live, as de produção. Cada uma tem seu próprio login e segredo.
Passo 2. Crie o sistema de pagamento na Tilda
- Tilda → Site settings → Payment systems → Universal payment system → modelo «New payment system (for developers)».
- Campos principais: Login e Secret for order signing, do passo 1; Currency: USD, EUR ou outra moeda aceita pela UTOPAY (RUB não é aceito); Country.
- Configurações avançadas → API URL: o valor do passo 1 (
https://api.utopay.app/tilda/pay). - Correspondência de campos: Login →
login, Currency →currency, Notification URL →notify_url, Order number →order_number, Order description →order_description, Order amount →order_amount, Buyer email →client_email, Signature →signature. - Assinatura do pedido: regras personalizadas
{{login}}{{order_amount}}{{order_number}}{{secret}}, algoritmo SHA-256, marque «Use the secret as the algorithm key (HMAC)». - Assinatura da notificação: regras personalizadas
{{login}}{{order_amount}}{{order_number}}{{secret}}{{paid}}, SHA-256, HMAC. Indicador de sucesso: campopaid, valor1. Id da transação:transaction_id. - Salve, republique as páginas com o carrinho, faça um pedido de teste e clique no botão verde ✅ no sandbox da UTOPAY — a Tilda mostra o pedido como pago. Depois repita o passo 1 com a chave live e troque o login e o segredo.
Opções na API URL
| Adicione à API URL | O que faz |
|---|---|
?method=crypto&coin=bep20/usdt | Cripto em vez de cartão (1,5%). Adicione sua carteira para a rede no painel → Funds & payouts. |
?provider=paypal | Envia os compradores direto para um método de cartão (stripe, paypal, revolut…). |
?success=https://seu-site/obrigado | Página para onde o comprador volta após pagar (padrão: a página inicial do seu site). |
As opções se combinam: https://api.utopay.app/tilda/pay?method=crypto&coin=bep20/usdt&success=https://seu-site/obrigado. Para oferecer cartão e cripto, crie na Tilda dois sistemas de pagamento universais com API URLs diferentes.
Como o pedido é confirmado
A Tilda assina cada pedido com o seu segredo (HMAC-SHA256); a UTOPAY recusa um pedido com assinatura errada, então o valor não pode ser alterado no caminho. Após o pagamento, a UTOPAY envia à Tilda uma notificação assinada da mesma forma, com paid = 1 e o id do pagamento da UTOPAY; a Tilda confere a assinatura, o número do pedido e o valor e marca o pedido como pago. Se a Tilda não responder, a UTOPAY tenta de novo por seis horas.
Histórico de versões
- 1.0 — Sistema de pagamento universal: cartão / PayPal e cripto, pedidos e notificações assinados.
Atualizado · Equipe de integrações da UTOPAY