Começar grátis
Português

Lojas online

Adicione pagamento cripto sem substituir os pagamentos que já usa

Seu checkout com cartão continua funcionando exatamente como hoje. Isto acrescenta mais uma forma de pagar, para os clientes que a querem — um único link na sua página que os leva a um checkout hospedado e paga você diretamente, sem nada rodando na sua loja.

Começar grátisLinks de pagamento

O que você realmente cola

Um botão de pagamento é configurado uma vez no painel — valor, ativo, redes e para onde mandar o cliente depois. O que você cola na sua página é isto:

<a href="https://pay.unheld.io/pay/btn_8f2c41"
   style="display:inline-block;padding:12px 20px;border-radius:8px;background:#3B37F0;color:#fff;font-weight:600;text-decoration:none;font-family:system-ui,sans-serif">
  Pay with crypto
</a>

Essa é a integração inteira. É uma tag de link.

Por que um link e não um script

Um trecho de código numa página pública não pode guardar chave secreta — qualquer pessoa a lê. Por isso o botão carrega apenas um id público impossível de adivinhar, e a fatura é criada no servidor quando ele é clicado. Nada da sua conta fica exposto na sua loja, não há script para deixá-la lenta ou quebrá-la, e não há biblioteca para manter atualizada.

O que acontece quando o cliente clica

Quatro passos, e nenhum deles roda no seu servidor.

  1. 01

    Ele cai num checkout hospedado

    O link cria a fatura a partir da sua configuração salva e envia o cliente para uma página que nós hospedamos. Você não renderiza formulário de pagamento, não guarda valor em campo oculto e não confia em nada que o navegador devolve.

  2. 02

    Ele paga de qualquer carteira

    O dinheiro vai para um endereço derivado da sua própria carteira. Não passa por nós, então não há saldo para sacar nem repasse para esperar.

  3. 03

    Sua referência volta junto

    Você pode anexar campos próprios a um botão — número do pedido, id do carrinho, o que sua loja usar. Ele atravessa o pagamento e volta no webhook, então você sabe qual pedido foi pago sem conciliar valores.

  4. 04

    O cliente é devolvido a você

    Cada botão tem suas próprias URLs de sucesso e cancelamento, para o cliente voltar à sua página de confirmação em vez de ficar parado na nossa.

Saber que um pedido foi pago

São os eventos de fatura de sempre — um pagamento por botão é uma fatura normal, não uma espécie à parte com um fluxo próprio meio suportado.

  1. invoice.created
  2. invoice.receiving
  3. invoice.confirming
  4. invoice.paid
  5. invoice.underpaid
  6. invoice.overpaid
  7. invoice.expired

Todo webhook é assinado e reenviado, e carrega os campos de referência que você anexou ao botão. Espere o evento de confirmação antes de despachar, não a primeira detecção do pagamento — a diferença entre os dois é exatamente para isso que as confirmações existem.

Como funciona a integração

A integração é um link. Isto é exatamente o que ele cobre, para medir o trabalho antes de começar.

  • Ainda não existe uma app nativa de Shopify nem um plugin de WooCommerce. A integração é o link acima, colado onde a sua plataforma permitir HTML — o que todas permitem. Os plugins nativos estão no roteiro.
  • Não há integração com o carrinho. O botão carrega o valor que você configurou, então um total variável exige a API em vez de um botão salvo.
  • Nada é marcado como atendido automaticamente para você. O webhook avisa ao seu sistema que um pedido específico foi pago; agir com base nisso é trabalho da sua loja.
  • Não há reembolso através de nós, porque nunca ficamos com o dinheiro. Devolvê-lo é um pagamento que você faz da sua própria carteira, nos seus termos.
  • Seu cliente precisa de uma carteira cripto e de saldo nela. Isto alcança quem já tem uma; não converte quem não tem.

Perguntas

Preciso sair do meu provedor de pagamentos atual?

Não, e não deveria. Isto acrescenta uma opção de pagamento ao lado das que você já oferece: seu checkout com cartão fica intacto e continua atendendo quem o usa. Cripto é uma fatia pequena dos pedidos da maioria das lojas; tratá-la como acréscimo e não como migração é ao mesmo tempo a leitura honesta e a que não coloca seu faturamento em risco.

Funciona com Shopify, WooCommerce ou a minha plataforma?

Funciona em qualquer lugar onde você possa colar HTML, o que cobre quase todas as plataformas — página de produto, landing page, rodapé de e-mail. O que não existe é app ou plugin nativo para nenhuma delas, então não há total de carrinho automático, nem status de pedido escrito no seu admin, nem instalação em um clique. Se você precisa disso, ainda não está pronto para você.

E pedidos com total diferente a cada vez?

Um botão salvo carrega valor fixo, então um carrinho variável precisa de uma fatura criada pela API na hora do checkout — uma requisição, e você recebe a URL de pagamento para onde mandar o cliente. O botão é para itens de preço fixo; a API é para todo o resto.

Quando é seguro despachar o pedido?

Quando chega o evento de confirmação, não quando o pagamento é detectado pela primeira vez. Detecção significa que uma transação apareceu; confirmação, que ela já está funda o bastante na rede para ser definitiva. Os dois chegam como webhooks separados justamente para você mostrar um “pagamento recebido” rápido e ainda segurar o envio físico até liquidar.

Faça um pedido de teste na testnet

Crie um botão, cole numa página e pague com moedas de testnet. Você verá a fatura, o redirecionamento e o webhook se comportarem exatamente como com dinheiro real.

Começar grátis

Links de pagamento · Desenvolvedores · Preços · Não custodial · Respostas diretas.