Começar grátis
Português

Pagamentos cripto em WooCommerce: como aceitar com a Unheld

A Unheld não tem plugin nativo para WooCommerce. Não precisa de um para receber: você adiciona um link de pagamento ao seu site de WooCommerce, ao lado do seu checkout se tiver um, e o cliente paga em uma página hospedada.

A Unheld não substitui nenhum checkout que você já tenha em WooCommerce. Um pagamento cripto pela Unheld é um pagamento separado, em uma página hospedada, então WooCommerce não o enxerga e não marca um pedido como pago automaticamente. O que segue é o caminho que funciona hoje e o que você precisa fazer por conta própria, já que não há plugin para fazer por você.

O WooCommerce roda sobre o WordPress, que permite adicionar seu próprio código. Isso importa para uma etapa abaixo: um desenvolvedor pode receber no seu site o webhook assinado da Unheld e marcar o pedido como pago. Nenhum plugin faz isso por você hoje.

Os passos, em ordem

  1. Crie um botão de pagamento no seu painel da Unheld

    Escolha o valor, a moeda e a rede, e para onde o cliente deve ir depois de pagar. O botão é um link hospedado, não um script, então nada no seu site de WooCommerce guarda uma chave secreta.

  2. Copie o link de pagamento

    O painel mostra o link de pagamento do botão. Cada clique vindo de um novo endereço de rede cria uma fatura com as configurações salvas do botão; clicar de novo do mesmo endereço enquanto essa fatura estiver aberta devolve a mesma fatura.

  3. Coloque o link no seu site de WooCommerce

    Adicione onde WooCommerce deixar colocar um link ou um bloco de HTML: um botão em uma página, uma página de produto, um link no menu. Ele fica ao lado de qualquer checkout que você já tenha; nunca o substitui.

  4. Decida como você vai saber que um pedido foi pago

    A Unheld envia um webhook assinado quando uma fatura é paga, e o pagamento aparece no seu painel e, se você vinculou, no Telegram. WooCommerce não recebe nada disso, então você marca o pedido como pago à mão ou o seu próprio código recebe o webhook. Para saber a que pedido um pagamento pertence, declare primeiro um campo de referência no botão e depois passe seu valor no link. Ele volta no webhook, mas vem do navegador do visitante, e um novo clique do mesmo endereço devolve a fatura que já existe, com a primeira referência. Trate-o como uma referência a conferir, não como prova de quem pagou nem de qual pedido se trata.

  5. Teste primeiro em uma testnet

    A Unheld lista redes de teste cujas moedas não custam nada. Crie um botão em uma delas, pague de uma carteira de teste e veja o pagamento chegar antes de um cliente de verdade.

Leia a seguir

Perguntas frequentes

Existe um plugin da Unheld para WooCommerce?

Não. Não há plugin nativo para WooCommerce, e este guia não finge o contrário. O que existe hoje é um link de pagamento e uma página de pagamento hospedada que você coloca no seu site de WooCommerce, mais webhooks assinados se você consegue recebê-los.

Isso substitui o checkout que já uso em WooCommerce?

Não. Qualquer checkout que você já tenha continua funcionando. O pagamento cripto é uma opção a mais para os clientes que quiserem, feita em uma página hospedada da Unheld e paga direto para uma carteira que você controla.

WooCommerce vai marcar o pedido como pago automaticamente?

Sozinha não, porque WooCommerce não enxerga o pagamento. Você marca o pedido como pago quando o pagamento aparece no painel, ou um desenvolvedor adiciona ao seu site um código que recebe o webhook assinado da Unheld e faz isso por você.

A Unheld guarda o dinheiro enquanto o cliente paga?

Não. O pagamento vai direto para um endereço de uma carteira que só você controla. A Unheld acompanha a rede e avisa que chegou; nunca guarda os fundos.

Com quais moedas os clientes da minha loja em WooCommerce podem pagar?

A moeda e a rede que você escolher ao criar o botão, entre as que a Unheld lista na página de moedas aceitas. Para mais de uma moeda, crie um botão para cada uma. Escolha uma stablecoin se quiser que o preço não mude entre a fatura e o pagamento.