RugWard Pay
Faturas, links de pagamento e pagamentos de teste
Crie faturas no painel, compartilhe links e botões de pagamento reutilizáveis, teste todo o checkout de graça numa testnet e trate pagamentos sem correspondência.
Nesta página
Criar uma fatura#
No painel, preencha New invoice e clique em Create invoice. Você recebe um link de pagamento para enviar ao comprador (https://rugward.com/pay/i/<id>).
| Campo | Regras | Observações |
|---|---|---|
| ① Amount (USD) | US$ 1 a US$ 50.000, no máximo 2 casas decimais (25 ou 25.50) | O comprador paga o equivalente na moeda que escolher. |
| ② Expires after | 30 minutos, 1 hora (padrão), 3 horas, 1 dia ou 7 dias no painel; 15 minutos a 7 dias pela API | Após a expiração, o checkout diz "Do not send anything" e nenhuma nova cotação pode ser travada. |
| ③ Order id (opcional) | até 64 caracteres: letras, dígitos e . _ - : # / | A sua própria referência; devolvida na API e nos webhooks. |
| ④ Return URL (opcional) | endereço https:// completo | Mostrado ao comprador somente depois que a fatura é paga, como um botão "Return to <o seu site>". |
| Description (opcional) | até 200 caracteres | Mostrada ao comprador, por exemplo "1 × camiseta, tamanho M". |
O comprador escolhe a moeda no checkout. A cotação fica travada por 30 minutos a partir desse momento (não da criação da fatura), então uma fatura de validade longa não expõe você a variações de preço.
Só envie o pedido depois que o painel (ou o webhook invoice.paid) disser Paid. Um comprador chegando à sua URL de retorno não é prova de pagamento: qualquer pessoa pode abrir uma URL.
Lista e detalhes das faturas#
Invoices mostra as suas faturas mais recentes com data, valor, id do pedido e status. Details abre uma fatura: as cotações (moeda, valor, taxa, endereço), cada pagamento visto on-chain com as confirmações e o link do explorador, e os botões Open checkout, Payment proof (faturas pagas) e Cancel invoice.
Rótulos de status que você verá:
| Rótulo | Status na API |
|---|---|
| Awaiting payment (aguardando pagamento) | open |
| Payment detected, confirming (pagamento detectado, confirmando) | pending |
| Paid (paga) | paid |
| Paid (more than requested) (paga a mais) | overpaid |
| Underpaid (paga a menos) | underpaid |
| Paid after expiry (paga após expirar) | late |
| Expired (expirada) | expired |
| Canceled (cancelada) | canceled |
O que cada um significa e o que fazer: Status, confirmações e provas.
Cancelar uma fatura#
Você pode cancelar a sua própria fatura enquanto ela estiver open e nenhum pagamento tiver sido visto. O checkout então avisa o comprador: "The merchant canceled this invoice. Do not send anything to it." Webhook: invoice.canceled. Uma fatura com um pagamento a caminho não pode ser cancelada (409).
Links e botões de pagamento#
Um link de pagamento é um link reutilizável com preço fixo: um produto, uma doação, uma assinatura mensal. Cada comprador que clica em Pay with crypto recebe a sua própria fatura nova (válida por 60 minutos), então os pagamentos nunca se misturam.
- Informe o valor em USD, uma descrição e uma URL de retorno opcional, depois Create link.
- O painel mostra a visão do comprador (exatamente o que os compradores veem), o link
https://rugward.com/pay/l/<id>e quantas vezes foi usado. - Copy link para compartilhar num chat, e-mail ou rede social, ou Copy button HTML para colocar um botão "Pay with crypto" no seu site.
- Turn off desativa o link. Faturas já criadas a partir dele não são afetadas.
O botão é um link HTML simples. Não carrega nenhum script nem grava cookies:
<a href="https://rugward.com/pay/l/k33JZ0ij5F2yLDprwrQgjN" target="_blank" rel="noopener"
style="display:inline-block;padding:10px 20px;border-radius:12px;background:#f0b90b;color:#000;font:600 15px system-ui,sans-serif;text-decoration:none">Pay with crypto</a>
Bom saber:
- Faturas criadas a partir de um link levam o id de pedido
link:<primeiros 8 caracteres do id do link>, para você distingui-las na lista, na API e nos webhooks. - Limites: 100 links ativos por comerciante; um link cria no máximo 100 faturas por hora (protege a sua cota horária de faturas contra abuso). A abertura de um link é protegida pelo Cloudflare Turnstile quando necessário.
Faturas de teste (grátis, testnet Sepolia)#
Abra Test invoice (Sepolia testnet) no painel para testar o checkout completo sem dinheiro real. O comprador paga com ETH de teste da Sepolia ou o USDC de teste da Sepolia da Circle pelo splitter do RugWard Pay implantado na Sepolia, que envia 99,5% ao endereço de recebimento e 0,5% à carteira de taxas do RugWard, exatamente como na Base.
- Valor: US$ 1 a US$ 100. Endereço de recebimento de teste opcional (um endereço EVM); caso contrário, é usado o seu endereço EVM.
- Moedas de teste não têm valor. São gratuitas: ETH da Sepolia de um faucet (por exemplo o faucet Sepolia do Google Cloud) e USDC de teste do faucet da Circle (escolha Ethereum Sepolia).
- Faturas de teste são marcadas TEST no checkout, na lista e na prova; nunca chamam o seu webhook e não podem ser criadas com uma chave de API, então um teste nunca pode disparar o envio de um pedido real.
Pagamentos sem correspondência#
Às vezes uma transferência chega ao seu endereço sem corresponder exatamente a uma fatura: valor errado, pagamento enviado muito depois da expiração ou uma transferência sem relação. O RugWard nunca marca esses casos como pagos automaticamente. Se existirem, o painel mostra uma caixa Unmatched payments com o valor, a rede, o link da transação e a fatura que estava sendo verificada quando o pagamento foi visto.
O que fazer: abra a transação, fale com o comprador e resolva você mesmo (entregue o pedido ou devolva o dinheiro da sua carteira). Depois clique em Dismiss.
Última atualização: 30 de outubro de 2026