Tukuyin ang hangganan ng wallet
Ang watch-only wallet ay makaka-detect ng mga pagbabayad nang hindi hawak ang private spending keys. Ang extended public key ay naglalantad pa rin ng sensitibong aktibidad ng wallet at dapat protektahan. Ang Lightning integration ay maaaring mangailangan ng online wallet at nagdadagdag ng karagdagang operational risk.
Sukatin para sa buong stack
Ang Bitcoin backend, database, web service at opsyonal na Lightning node ay may magkaibang pangangailangan sa storage at memory. Suriin ang kasalukuyang sinusuportahang deployment instruction at pangangailangan sa paglago bago pumili ng maliit na makina.
I-secure ang merchant interface
Gumamit ng dedicated hostname, HTTPS, matibay na login protection at restricted na administrative access. Panatilihing updated ang server at tiyakin ang webhook signature o sinusuportahang verification mechanism sa tumatanggap na application. Huwag magpadala ng produkto batay lamang sa browser redirect.
I-back up at i-reconcile
Protektahan ang configuration ng tindahan, database, impormasyon sa pagbawi ng wallet at Lightning-specific na materyal ayon sa kaugnay na dokumentasyon. Subukan ang pagbawi at i-reconcile ang mga invoice laban sa payment system, lalo na sa paligid ng expiry, underpayment at refunds.
Suriin ang deployment at chain strategy
Gamitin ang kasalukuyang sinusuportahang deployment instructions, dedikadong hostname at verified na HTTPS route. Ang pruned chain ay makakabawas ng patuloy na storage requirement kung sinusuportahan, ngunit dapat maunawaan ang rescan at recovery needs. Huwag pumili ng disk batay lamang sa kasalukuyang laki ng chain; maglaan ng espasyo para sa buong stack at paglaki.
- I-verify ang payment callback mula sa isang panlabas na pagsubok
- Gumamit ng test payment bago ang live na tindahan
- Kumpirmahin ang patakaran sa invoice settlement
Opisyal na dokumentasyon: Mga opsyon sa deployment ng BTCPay
Ilagay ang spending key kung saan mo ito nilalayon
Ang watch-only setup ay makaka-detect ng mga pagbabayad mula sa extended public key nang hindi ibinibigay sa server ang spending key. Sensitibo ang xpub dahil maaari nitong ilantad ang aktibidad ng wallet. Binabago ng hot wallet ang panganib na ito sa pamamagitan ng paglalagay ng spending capability online. Suriin nang hiwalay ang wallet at Lightning custody at sundin ang sinusuportahang backup process.
Opisyal na dokumentasyon: Modelo ng BTCPay wallet
Bumuo ng deployment checklist para sa napiling stack
Magsimula sa isang dedikadong domain, sinusuportahang paraan ng deployment, nilalayong chain mode at sapat na disk headroom para sa synchronisation. Suriin ang upstream Docker generator at ang mga napiling bahagi nito bago mag-install; panatilihin ang mga hindi-sekretong pagpipilian sa deployment upang ang ibang makina ay maaaring muling buuin nang pare-pareho. Suriin ang domain resolution, pag-isyu ng certificate at pagmamay-ari ng administrative account bago magpakita ng checkout sa mga customer. Ang isang generic na halimbawa ng Docker Compose ay hindi patunay na ang bawat opsyonal na bahagi ng BTCPay ay naka-configure.
- Magpasya kung aling may-ari ng instance ang kumokontrol sa mga update, monitoring, backup at incident response.
- Ihiwalay ang reverse-proxy exposure mula sa pribadong Bitcoin RPC, database at Lightning administration.
- Idokumento ang recovery/rescan limits ng pruned backend bago ikonekta ang wallet na may makasaysayang pagbabayad.
- Panatilihin ang isang sinusuportahang test environment o maliit na kontroladong payment exercise para sa mga integration bago tuparin ang mahahalagang order.
Opisyal na dokumentasyon: BTCPay Server: mga pagpipilian sa deployment · BTCPay Server: sinusuportahang Docker deployment
Siyasatin ang mga nawawalang bayad sa wallet nang hindi nag-i-import ng seed
Maaaring gamitin ng isang store ang xpub/derivation information ng wallet habang nananatili ang spending key sa ibang device. Subukan ang pagtanggap at ang recovery path gamit ang napiling wallet. Kung nakikita ng BTCPay ang bayad sa invoice ngunit hindi ito lumalabas sa external wallet, suriin ang derivation scheme at address gap-limit behavior nito bago ipagpalagay na nawala ang pondo. Ang mahahabang sunod-sunod na hindi bayad na generated address ay maaaring makaapekto sa discovery ng wallet. Gumamit ng sinusuportahang wallet diagnostics sa halip na kopyahin ang recovery words sa server.
Opisyal na dokumentasyon: BTCPay Server: pag-troubleshoot ng wallet at derivation
I-reconcile ang mga invoice bago ang fulfilment
Itala ang mga invoice identifier at gawing idempotent ang fulfilment operation. Ang pagbabalik ng browser sa shop ay navigation event, hindi patunay ng settlement. Beripikahin ang payment state sa pamamagitan ng iyong authenticated server integration, tahasang pangasiwaan ang mga expired, late o underpaid invoice, at panatilihin ang review path para sa mga hindi pa nalulutas na kinalabasan. Kung umuulit ang callback, ang pagbabalik ng successful acknowledgement ay hindi dapat magpadala o mag-credit ng order nang dalawang beses.
- Subukan ang pagbabayad na dumarating malapit sa pag-expire at i-verify na nananatiling nauugnay ang order sa tamang invoice.
- Panatilihin ang database, configuration ng store at wallet recovery material sa isang nasubok na independiyenteng backup.
- Ang Lightning ay nagdaragdag ng hiwalay na responsibilidad sa liquidity at channel-backup; ang pag-restore ng buong VPS ng kahapon ay hindi isang ligtas na pangkalahatang pamamaraan ng recovery.
- Ang pagho-host ng isang BTCPay instance ay hindi nagdaragdag ng Lightning o XMR sa checkout ng customer ng KoalaVPS; ang mga paraan ng pagbabayad sa hosting site na ito ay nananatiling pitong na-publish na ruta nito.
Opisyal na dokumentasyon: Gabay ng developer sa Bitcoin: pag-verify ng payment · LND: disaster recovery · Core Lightning: backup ng wallet at channel