Stablecoin nel tuo checkout BTCPay.

Installa

1. Scarica BTCPayServer.Plugins.WhollyCrypto.btcpay e confrontalo con il file della release SHA256SUMS. Usa il file del plugin, non lo ZIP dei sorgenti di GitHub.
2. Come amministratore BTCPay, apri Gestisci plugin → Carica plugin, carica il file e riavvia BTCPay.
3. Seleziona un negozio → Plugin → Wholly Crypto. La sola installazione non collega un negozio.

Gli aggiornamenti usano lo stesso caricamento. Aggiornare il software merchant Wholly non aggiorna il plugin BTCPay.

Collega un negozio

1. In Wholly, crea un progetto e un negozio abilitati con metodi accettati, wallet con backup, tassi e conferme. Usa un'installazione merchant aggiornata; questo connettore è destinato all'API 6.4.5.
2. Copia gli UUID di progetto e negozio da Negozio → Generale → ID API. Crea una credenziale API in lettura/scrittura limitata al progetto. Attiva Negozio → IPN e copia il relativo segreto di firma, non un segreto webhook.
3. Nelle impostazioni Wholly di BTCPay, inserisci quei valori e le origini API e checkout, ad esempio https://api.example.com e https://pay.example.com. Usa HTTPS pubblico sulla porta 443, senza percorsi.
4. Attiva Offri Wholly Crypto al checkout, salva, poi Prova accesso in lettura. Puoi scegliere un sottoinsieme dei metodi accettati dal negozio.

Consenti i callback HTTPS dal tuo server Wholly a BTCPay attraverso entrambi i firewall. Il plugin fornisce l'URL di callback. Escludi login del browser, CAPTCHA e Basic Auth da quella rotta; i controlli delle firme devono restare attivi.

Checkout incorporato

Il checkout a pagina intera è predefinito, particolarmente utile per le app wallet mobili. Per un iframe:

1. In Wholly, in Negozio → Avanzate, attiva Consenti checkout incorporato. Aggiungi l'origine HTTPS esatta di BTCPay a Origini HTTPS consentite, senza percorso né caratteri jolly.
2. Nelle impostazioni del plugin BTCPay, scegli Checkout cliente → Checkout incorporato (iframe) e salva.
3. Prova una nuova fattura. Le fatture esistenti mantengono la modalità di visualizzazione originale. Apri checkout completo resta disponibile per la stessa fattura se il frame non si carica.

Messaggi del browser e link di ritorno servono alla navigazione, non sono mai prove di pagamento.

Verifica il flusso di pagamento

Crea una fattura fiat di piccolo importo positivo in un negozio di test. Seleziona Stablecoin e crypto · Wholly. Verifica checkout, IPN firmato e verifica API fino alla conferma. Evadi solo sulla base della fattura saldata di BTCPay, una volta per ordine.

Prova accesso in lettura non testa la creazione di fatture o IPN. Usa Connessione e Pagamenti collegati per errori che non espongono dati sensibili, riferimenti degli ordini e controlli dei pagamenti.