Stablecoins no seu checkout BTCPay.

Instalar

1. Baixe BTCPayServer.Plugins.WhollyCrypto.btcpay e verifique com o arquivo da versão SHA256SUMS. Use o arquivo do plugin, não o ZIP do código-fonte do GitHub.
2. Como administrador do BTCPay, abra Manage Plugins → Upload Plugin, envie o arquivo e reinicie o BTCPay.
3. Selecione uma loja → Plugins → Wholly Crypto. Só instalar não conecta uma loja.

As atualizações usam o mesmo processo de envio. Atualizar o software de lojista Wholly não atualiza o plugin BTCPay.

Conectar uma loja

1. No Wholly, crie um projeto e uma loja habilitados com formas aceitas, carteiras com backup, cotações e confirmações. Use uma instalação atual do lojista; este conector foi feito para a API 6.4.5.
2. Copie os UUIDs do projeto e da loja de Loja → Básico → IDs da API. Crie uma credencial de API de leitura/gravação restrita ao projeto. Ative Loja → IPN e copie o segredo de assinatura dele, não um segredo de webhook.
3. Nas configurações Wholly do BTCPay, insira esses valores e as origens da sua API e do checkout, como https://api.example.com e https://pay.example.com. Use HTTPS público na porta 443; sem caminhos.
4. Ative Oferecer Wholly Crypto no checkout, salve e depois Testar acesso de leitura. Se quiser, escolha um subconjunto das formas aceitas pela loja.

Permita notificações HTTPS do seu servidor Wholly para o BTCPay pelos dois firewalls. O plugin fornece a URL de notificação. Não aplique a essa rota logins de navegador, CAPTCHA nem Basic Auth; as verificações de assinatura devem continuar ativadas.

Checkout incorporado

O checkout em página inteira é o padrão, especialmente útil para apps de carteiras móveis. Para um iframe:

1. No Wholly, em Loja → Avançado, ative Permitir checkout incorporado. Adicione a origem HTTPS exata do seu BTCPay a Origens HTTPS permitidas, sem caminho nem curinga.
2. Nas configurações do plugin do BTCPay, escolha Checkout do cliente → Checkout incorporado (iframe) e salve.
3. Teste uma fatura nova. Faturas existentes preservam o modo de exibição original. Abrir checkout completo continua disponível para a mesma fatura se o quadro não puder carregar.

Mensagens do navegador e links de retorno servem para navegação, nunca comprovam o pagamento.

Verificar o fluxo de pagamento

Crie uma fatura fiduciária pequena e positiva em uma loja de testes. Selecione Stablecoins e cripto · Wholly. Verifique o checkout, o IPN assinado e a verificação por API até a confirmação. Entregue só a partir da fatura liquidada do BTCPay, uma vez por pedido.

Testar acesso de leitura não testa a criação de faturas nem IPN. Use Conexão e Pagamentos vinculados para ver erros seguros, referências de pedidos e verificações de pagamentos.