BTCPay Server με υποστήριξη Zcash: Πλήρης οδηγός εγκατάστασης και ενσωμάτωσης
Το BTCPay Server επιτρέπει στις online επιχειρήσεις να δέχονται πληρωμές σε κρυπτονομίσματα απευθείας, χωρίς μεσάζοντες ή θεματοφύλακες. Αυτός ο οδηγός σε καθοδηγεί σε ολόκληρη τη διαδικασία ρύθμισης του BTCPay Server με εγγενή υποστήριξη για θωρακισμένες πληρωμές Zcash.
Αυτή η τεκμηρίωση εστιάζει στην ενσωμάτωση του Zcash στην εγκατάσταση BTCPay Server σου.
Υποστηρίζει ρυθμίσεις τόσο με πλήρη κόμβο (Zebra) όσο και βασισμένες στο lightwalletd.
Πίνακας περιεχομένων
Γιατί να χρησιμοποιήσεις το BTCPay Server με το Zcash
Το online εμπόριο δέχεται όλο και περισσότερο κρυπτονομίσματα. Είναι γρήγορα, παγκόσμια και λειτουργούν χωρίς τράπεζες. Αυτό ωφελεί τόσο τους εμπόρους όσο και τους πελάτες. Όμως υπάρχει μια σημαντική λεπτομέρεια που πολλοί παραβλέπουν.
Κατά την υποβολή μιας παραγγελίας, ο πελάτης συνήθως παρέχει προσωπικές πληροφορίες: όνομα, διεύθυνση αποστολής και αριθμό τηλεφώνου. Αν η πληρωμή γίνεται με χρήση ενός δημόσιου blockchain - όπως Bitcoin, Ethereum ή stablecoins στο Ethereum ή στο Tron - η συναλλαγή γίνεται μόνιμα ορατή για ανάλυση.
Οποιοσδήποτε, ακόμη και χωρίς να γνωρίζει τι παραγγέλθηκε, μπορεί να:
- δει πότε και πόσο πληρώθηκε
- εντοπίσει από πού προήλθαν τα κεφάλαια και πού κατέληξαν
- συνδέσει μια διεύθυνση κρυπτονομίσματος με ένα πραγματικό πρόσωπο εάν υπάρχει οποιοδήποτε σημείο συσχέτισης (για παράδειγμα, ένα διαρρεύσαν email ή όνομα αποστολής)
Αυτό σημαίνει ότι μία μόνο αγορά μπορεί να αποκαλύψει ολόκληρο το οικονομικό ιστορικό ενός πελάτη.
Και λειτουργεί και αντίστροφα. Αν η διεύθυνση ενός εμπόρου έχει εμφανιστεί ποτέ on-chain, εκτίθεται. Ανταγωνιστές και τρίτοι παρατηρητές μπορούν να παρακολουθούν τον όγκο πληρωμών, τη δραστηριότητα προμηθευτών και τη δομή των επιχειρηματικών ροών.
Ο συνδυασμός των BTCPay Server και Zcash μπορεί να λύσει αυτό το πρόβλημα.
Το BTCPay Server είναι ένα δωρεάν και αποκεντρωμένο σύστημα για τη λήψη πληρωμών σε κρυπτονομίσματα.
Δεν είναι μεσάζοντας πληρωμών και δεν διακρατεί κεφάλαια. Όλες οι πληρωμές πηγαίνουν απευθείας στο πορτοφόλι του εμπόρου.
Αυτό μπορεί να είναι ένα προσωπικό πορτοφόλι ή μια ρύθμιση multisig εντός ενός οργανισμού.
Ο διακομιστής διαχειρίζεται εργασίες συντονισμού:
- δημιουργεί μια μοναδική διεύθυνση για κάθε παραγγελία
- παρακολουθεί πότε λαμβάνεται η πληρωμή και τη συνδέει με την παραγγελία
- εκδίδει αποδείξεις και ειδοποιήσεις
- παρέχει μια διεπαφή πληρωμής για τον πελάτη
Όλα λειτουργούν υπό τον έλεγχο του ιδιοκτήτη του καταστήματος, χωρίς εξάρτηση από υπηρεσίες τρίτων.
Το Zcash είναι ένα κρυπτονόμισμα που βασίζεται σε αποδείξεις μηδενικής γνώσης. Υποστηρίζει ένα πλήρως ιδιωτικό μοντέλο συναλλαγών.
Όταν χρησιμοποιούνται θωρακισμένες διευθύνσεις (οι οποίες στο εξής θα αναφέρονται απλώς ως “διευθύνσεις”), ο αποστολέας, ο παραλήπτης και το ποσό της συναλλαγής δεν αποκαλύπτονται στο blockchain.
Για online καταστήματα, αυτό σημαίνει:
- Ο αγοραστής μπορεί να ολοκληρώσει την πληρωμή χωρίς να αποκαλύψει το οικονομικό ιστορικό του
- Ο πωλητής λαμβάνει πληρωμή χωρίς να εκθέτει τη διεύθυνσή του, τον όγκο πωλήσεων ή τη δομή των συναλλαγών
- Κανένας εξωτερικός παρατηρητής δεν μπορεί να συνδέσει την πληρωμή με την παραγγελία ή με δεδομένα πελατών
Πρακτικό παράδειγμα
Ένας χρήστης υποβάλλει μια παραγγελία και επιλέγει Bitcoin ή USDT ως μέθοδο πληρωμής.
Ο ιστότοπος δημιουργεί μια διεύθυνση πληρωμής και εμφανίζει το ποσό.
Αφού γίνει η πληρωμή, αυτή η διεύθυνση αποθηκεύεται στο blockchain και γίνεται δημόσια.
Ένας επιτιθέμενος χρειάζεται μόνο να συνδέσει μία παραγγελία με τη διεύθυνση για να αποκτήσει μακροχρόνια ορατότητα σε ολόκληρο το ιστορικό συναλλαγών της.
Τώρα φαντάσου την ίδια κατάσταση με το Zcash.
Το BTCPay Server δημιουργεί μια θωρακισμένη διεύθυνση. Ο αγοραστής στέλνει την πληρωμή.
Από την οπτική του blockchain, δεν συμβαίνει τίποτα. Δεν υπάρχουν δημόσια δεδομένα για ανάλυση.
Ο διακομιστής λαμβάνει επιβεβαίωση, τη συνδέει με την παραγγελία και ολοκληρώνει τη διαδικασία.
Για κάθε εξωτερικό παρατηρητή, μοιάζει σαν να μην συνέβη τίποτα.
Όλη η λογική παραμένει μεταξύ του καταστήματος και του πελάτη - όπως πρέπει.
Αυτή η λύση δεν θέτει σε κίνδυνο την αυτοματοποίηση ή τη χρηστικότητα.
Όλα λειτουργούν όπως και με άλλα κρυπτονομίσματα, απλώς χωρίς τον κίνδυνο διαρροών δεδομένων.
Πώς λειτουργεί το BTCPay Server
Το BTCPay Server λειτουργεί ως γέφυρα επεξεργασίας πληρωμών μεταξύ της πλατφόρμας ηλεκτρονικού εμπορίου σου και του blockchain. Δες πώς λειτουργεί η ροή:
-
Ο πελάτης υποβάλλει μια παραγγελία στον ιστότοπό σου (π.χ. WooCommerce, Magento ή οποιαδήποτε πλατφόρμα με ενσωμάτωση BTCPay).
-
Το κατάστημα ζητά ένα τιμολόγιο πληρωμής από το BTCPay Server. Ο διακομιστής δημιουργεί ένα μοναδικό τιμολόγιο με:
- Το ποσό της παραγγελίας
- Έναν χρονομετρητή αντίστροφης μέτρησης
- Μια ενοποιημένη διεύθυνση Zcash (UA) - π.χ.
u1... - που περιλαμβάνει από προεπιλογή έναν δέκτη Orchard (θωρακισμένο).
-
Ο πελάτης βλέπει τη σελίδα πληρωμής και στέλνει ZEC στην παρεχόμενη διεύθυνση.
-
Το BTCPay Server παρακολουθεί το blockchain, ελέγχοντας την πληρωμή ως προς:
- Το αναμενόμενο ποσό
- Τη διεύθυνση παραλαβής
- Τη χρονική σήμανση του τιμολογίου
-
Μόλις εντοπιστεί και επιβεβαιωθεί η συναλλαγή, το BTCPay ειδοποιεί το κατάστημα.
-
Ο πελάτης λαμβάνει επιβεβαίωση πληρωμής. Προαιρετικά, ο διακομιστής μπορεί να στείλει απόδειξη μέσω email.
Ολόκληρη αυτή η διαδικασία πραγματοποιείται αυτόματα, χωρίς μεσάζοντες ή θεματοφύλακες.
Το BTCPay Server δεν διακρατεί κεφάλαια - απλώς συνδέει το σύστημα παραγγελιών με το blockchain με ασφάλεια και ιδιωτικότητα.
Πού αποθηκεύονται τα κεφάλαια; Ποιος ελέγχει τα ιδιωτικά κλειδιά;
Το BTCPay Server δεν είναι πορτοφόλι και δεν απαιτεί ιδιωτικά κλειδιά.
Όλα τα κεφάλαια πηγαίνουν απευθείας στο πορτοφόλι του εμπόρου. Η ασφάλεια διασφαλίζεται με τη χρήση μιας αρχιτεκτονικής βασισμένης σε viewing key.
Πώς λειτουργεί
-
Το πορτοφόλι δημιουργείται εκ των προτέρων.
Ο έμπορος χρησιμοποιεί ένα πορτοφόλι Zcash που υποστηρίζει viewing keys - όπως Zkool ή Zingo! Wallet.
Μια πλήρης λίστα είναι διαθέσιμη στο ZecHub.wiki.
-
Το BTCPay Server συνδέεται μέσω ενός viewing key.
Ένα viewing key είναι ένα κλειδί μόνο για ανάγνωση: μπορεί να εντοπίζει εισερχόμενες πληρωμές και να δημιουργεί νέες διευθύνσεις παραλαβής,
αλλά δεν μπορεί να δαπανά κεφάλαια. Ο διακομιστής δεν αποθηκεύει φράσεις ανάκτησης ή ιδιωτικά κλειδιά.
-
Η πρόσβαση στα δεδομένα του blockchain γίνεται μέσω διακομιστή lightwalletd.
Μπορείς να χρησιμοποιήσεις έναν δημόσιο κόμβο όπως το https://zec.rocks ή να εκτελέσεις τη δική σου στοίβα Zebra + lightwalletd για πλήρη κυριαρχία.
-
Κάθε παραγγελία λαμβάνει μια μοναδική διεύθυνση.
Τα viewing keys επιτρέπουν στον διακομιστή να παράγει νέες θωρακισμένες διευθύνσεις Zcash για κάθε τιμολόγιο,
επιτρέποντας την ασφαλή παρακολούθηση πληρωμών και αποτρέποντας την επαναχρησιμοποίηση διευθύνσεων.
-
Διατηρείς τον πλήρη έλεγχο των κεφαλαίων.
Ακόμη και αν ο διακομιστής παραβιαστεί, κανείς δεν μπορεί να κλέψει τα χρήματά σου - μόνο μεταδεδομένα πληρωμών θα μπορούσαν να εκτεθούν.
Αυτός ο σχεδιασμός διαχωρίζει την υποδομή από τον έλεγχο περιουσιακών στοιχείων.
Μπορείς να ενημερώσεις, να μεταφέρεις ή να επανεγκαταστήσεις το BTCPay Server χωρίς να θέσεις κεφάλαια σε κίνδυνο.
Πώς να ρυθμίσεις το BTCPay Server για να δέχεσαι Zcash
Στις προηγούμενες ενότητες, εξηγήσαμε πώς λειτουργεί το BTCPay Server με το Zcash και γιατί έχει σημασία για πληρωμές που διατηρούν την ιδιωτικότητα. Τώρα είναι η ώρα να περάσεις στην πράξη.
Η ακριβής ρύθμισή σου θα εξαρτηθεί από διάφορους παράγοντες:
- Έχεις ήδη μια εγκατάσταση BTCPay Server;
- Θέλεις να χρησιμοποιήσεις έναν δημόσιο lightwalletd ή να εκτελέσεις τον δικό σου πλήρη κόμβο;
- Θα εκτελείται ο διακομιστής σε VPS ή στο σπίτι;
Αυτό το κεφάλαιο καλύπτει όλα τα τρέχοντα σενάρια ρύθμισης - από ελάχιστες διαμορφώσεις έως πλήρως κυρίαρχες αναπτύξεις.
Θα δούμε τα εξής:
- Πώς να αναπτύξεις τα πάντα από την αρχή σε ένα VPS, συμπεριλαμβανομένου του πλήρους κόμβου (Zebra)
- Πώς να εκτελέσεις το BTCPay Server στο σπίτι ενώ διατηρείς την IP σου κρυφή χρησιμοποιώντας το Cloudflare Tunnel
- Πώς να ενεργοποιήσεις και να ρυθμίσεις την υποστήριξη Zcash μέσα στη διαδικτυακή διεπαφή BTCPay Server
- Πώς να ενσωματώσεις το BTCPay με τον ιστότοπο ή το online κατάστημά σου
Ανάπτυξη του BTCPay Server με υποστήριξη Zcash
Ας προχωρήσουμε στην πραγματική ρύθμιση. Σε αυτή την ενότητα, θα εγκαταστήσουμε το BTCPay Server με υποστήριξη Zcash - είτε σε ένα νέο VPS είτε προσθέτοντας υποστήριξη ZEC σε μια υπάρχουσα εγκατάσταση.
Αν έχεις ήδη το BTCPay Server σε λειτουργία (π.χ. για BTC ή Lightning), δεν χρειάζεται να επανεγκαταστήσεις τα πάντα - απλώς ενεργοποίησε το plugin ZEC.
Θα εξετάσουμε διάφορες διαμορφώσεις, από ελάχιστες ρυθμίσεις που χρησιμοποιούν έναν δημόσιο κόμβο lightwalletd έως πλήρως κυρίαρχες εγκαταστάσεις με τον δικό σου πλήρη κόμβο.
Η καλύτερη επιλογή εξαρτάται από την τοποθεσία του διακομιστή σου και από το πόση ανεξαρτησία θέλεις από εξωτερική υποδομή.
Επίσημη τεκμηρίωση του plugin:
https://github.com/btcpay-zcash/btcpayserver-zcash-plugin
Προειδοποίηση - ένα πορτοφόλι ανά εγκατάσταση:
Το plugin Zcash χρησιμοποιεί ένα κοινόχρηστο πορτοφόλι σε όλα τα καταστήματα της εγκατάστασης BTCPay.
Αν φιλοξενείς πολλά ανεξάρτητα καταστήματα σε μία εγκατάσταση, θα μοιράζονται το ίδιο πορτοφόλι Zcash.
Χρησιμοποίησε ξεχωριστές εγκαταστάσεις αν χρειάζεσαι αυστηρή απομόνωση πορτοφολιών.
Προτεινόμενη ρύθμιση VPS
Πριν από την εγκατάσταση, βεβαιώσου ότι έχεις:
- Ένα VPS με Ubuntu 22.04+
- Ένα όνομα domain που δείχνει στη διεύθυνση IP του διακομιστή σου (μέσω DNS)
- Τα
git, docker και docker-compose εγκατεστημένα
- Πρόσβαση SSH στον διακομιστή
Προετοιμασία του διακομιστή σου (κρυφό μέρος)
Κάνε κλικ για επέκταση
Για να αναπτύξεις το BTCPay Server με υποστήριξη Zcash, θα χρειαστείς τα εξής:
1. VPS με Ubuntu 22.04 ή νεότερο
Συνιστούμε να χρησιμοποιήσεις μια ελάχιστη εγκατάσταση του Ubuntu Server 22.04 LTS.
Οποιοσδήποτε πάροχος VPS προσφέρει αποκλειστική διεύθυνση IP θα λειτουργήσει.
Ελάχιστες απαιτήσεις:
- 2 πυρήνες CPU
- 4 GB RAM
- 40 GB χώρου δίσκου
Αυτή η ρύθμιση επαρκεί αν χρησιμοποιείς το lightwalletd για το Zcash.
Αν σκοπεύεις να εκτελέσεις έναν πλήρη κόμβο Zcash, θα χρειαστείς τουλάχιστον 300 GB ελεύθερου χώρου δίσκου.
2. Όνομα domain που δείχνει στον διακομιστή σου
Στον πίνακα ελέγχου του παρόχου DNS σου, δημιούργησε μια εγγραφή A για ένα subdomain
(π.χ. btcpay.example.com) που δείχνει στη διεύθυνση IP του VPS σου.
Αυτό το domain θα χρησιμοποιείται για την πρόσβαση στο BTCPay Server από τον browser
και για την αυτόματη δημιουργία ενός δωρεάν πιστοποιητικού SSL μέσω Let's Encrypt.
3. Πρόσβαση SSH στον διακομιστή
Για να εγκαταστήσεις το BTCPay Server, πρέπει να συνδεθείς στο VPS σου μέσω SSH.
Από το τερματικό σου, εκτέλεσε:
ssh root@YOUR_SERVER_IP
Αν χρησιμοποιείς macOS, Linux ή WSL σε Windows, το SSH είναι ήδη διαθέσιμο στο τερματικό.
Σε απλά Windows, χρησιμοποίησε έναν client SSH όπως το PuTTY.
4. Εγκατάσταση Git, Docker και Docker Compose
Μόλις συνδεθείς μέσω SSH, ενημέρωσε τα πακέτα του συστήματός σου και εγκατάστησε τα απαιτούμενα στοιχεία:
Code-highlight
sudo apt update && sudo apt upgrade -y
sudo apt install git curl docker.io docker-compose-plugin -y
sudo systemctl enable docker
Στο Ubuntu 22.04 και νεότερο, το από το APT είναι παρωχημένο.
Το προτεινόμενο πακέτο είναι το , το οποίο παρέχει την εντολή (σημείωσε το κενό αντί για παύλα).
Βήμα 1: Κλωνοποίηση του αποθετηρίου
Δημιούργησε έναν κατάλογο εργασίας και κατέβασε την ανάπτυξη BTCPay Server Docker:
Code-highlight
mkdir BTCPayServer
cd BTCPayServer
git clone https://github.com/btcpayserver/btcpayserver-docker
cd btcpayserver-docker
Βήμα 2: Εξαγωγή μεταβλητών περιβάλλοντος
Αντικατάστησε το btcpay.example.com με το πραγματικό domain σου:
Code-highlight
export BTCPAY_HOST="btcpay.example.com"
export NBITCOIN_NETWORK="mainnet"
export BTCPAYGEN_CRYPTO1="btc"
export BTCPAYGEN_CRYPTO2="zec"
export BTCPAYGEN_REVERSEPROXY="nginx"
export BTCPAYGEN_LIGHTNING="none"
Αν σκοπεύεις να προσθέσεις Monero ή Litecoin αργότερα, μπορείς να τα συμπεριλάβεις τώρα:
Code-highlight
export BTCPAYGEN_CRYPTO3="ltc"
export BTCPAYGEN_CRYPTO4="xmr"
Μπορείς να προσθέσεις νέα νομίσματα οποιαδήποτε στιγμή εξάγοντας τις κατάλληλες μεταβλητές και εκτελώντας ξανά το script ρύθμισης:
. ./btcpay-setup.sh -i
Για αυτόν τον οδηγό, θα εστιάσουμε μόνο στο Zcash.
Βήμα 3: Εκτέλεση του προγράμματος εγκατάστασης
Εκτέλεσε το script ρύθμισης για να δημιουργήσεις και να εκκινήσεις τον διακομιστή:
. ./btcpay-setup.sh -i
Το script θα εγκαταστήσει εξαρτήσεις, θα δημιουργήσει το docker-compose.yml, θα εκκινήσει υπηρεσίες και θα ρυθμίσει το systemd.
Αυτό διαρκεί περίπου 5 λεπτά.
Μόλις ολοκληρωθεί, η εγκατάστασή σου BTCPay Server θα είναι διαθέσιμη στη διεύθυνση:
https://btcpay.example.com
Αν τροποποιείς μια υπάρχουσα εγκατάσταση (π.χ. προσθέτοντας ZEC), βεβαιώσου ότι θα σταματήσεις και θα επανεκκινήσεις τον διακομιστή με τις νέες ρυθμίσεις:
Code-highlight
cd ~/BTCPayServer/btcpayserver-docker
btcpay-down.sh
. ./btcpay-setup.sh -i
Έπειτα, προχώρησε στην επόμενη ενότητα για να ρυθμίσεις το Zcash στη διαδικτυακή διεπαφή BTCPay Server.
Εκτέλεση του δικού σου πλήρους κόμβου Zcash
Αν προτιμάς να μην βασίζεσαι σε δημόσιους κόμβους lightwalletd, μπορείς να αναπτύξεις τον δικό σου πλήρη κόμβο Zcash μαζί με το lightwalletd στον ίδιο διακομιστή.
Αυτό σου δίνει πλήρη αυτονομία - χωρίς εξωτερικές εξαρτήσεις και χωρίς να απαιτείται εμπιστοσύνη.
Βήμα 1: Εξασφάλισε επαρκή χώρο στον δίσκο
Ένας πλήρης κόμβος Zcash (Zebra + lightwalletd) απαιτεί επί του παρόντος πάνω από 300 GB χώρου στον δίσκο και συνεχίζει να μεγαλώνει.
Ανάλυση:
- Η βάση δεδομένων blockchain του Zebra: ~260-270 GB
- Η δημιουργία ευρετηρίου του lightwalletd: ~15-20 GB
Προτεινόμενος χώρος αποθήκευσης:
- 400 GB+ αν ο διακομιστής χρησιμοποιείται μόνο για πληρωμές Zcash
- 800 GB+ αν ο διακομιστής εκτελεί επίσης τα BTCPay Server, PostgreSQL, Nginx κ.λπ.
Ιδανικά, χρησιμοποίησε δίσκο SSD/NVMe με χωρητικότητα 1 TB, ειδικά αν δεν σκοπεύεις να περικόπτεις δεδομένα τακτικά.
Βήμα 2: Όρισε μεταβλητές περιβάλλοντος
Πρόσθεσε τα παρακάτω στη ρύθμιση του περιβάλλοντός σου για να ενεργοποιήσεις τη διαμόρφωση πλήρους κόμβου:
Code-highlight
export BTCPAYGEN_EXCLUDE_FRAGMENTS="zcash"
export BTCPAYGEN_ADDITIONAL_FRAGMENTS="zcash-fullnode"
Αυτό θα συμπεριλάβει το τμήμα zcash-fullnode, το οποίο εκκινεί και τα δύο zebrad και lightwalletd μέσα στο BTCPay Server.
Βήμα 3: Εκτέλεσε ξανά το πρόγραμμα εγκατάστασης
. ./btcpay-setup.sh -i
Το script θα:
- Κατεβάσει τις εικόνες Docker για τα Zebra και lightwalletd
- Ρυθμίσει τις υπηρεσίες μέσα στο stack του BTCPay
- Συνδέσει το plugin Zcash με την τοπική παρουσία
lightwalletd
Ο πλήρης συγχρονισμός του blockchain μπορεί να διαρκέσει αρκετές ημέρες, ειδικά σε διακομιστές VPS με περιορισμένους πόρους.
Μέχρι να ολοκληρωθεί ο συγχρονισμός, οι θωρακισμένες πληρωμές δεν θα είναι διαθέσιμες.
Σύνδεση σε εξωτερικό κόμβο lightwalletd
Στις περισσότερες περιπτώσεις, δεν απαιτείται πλήρης αυτονομία - και οι έμποροι μπορεί να μη θέλουν να αφιερώσουν χρόνο και χώρο στον δίσκο για την εκτέλεση ενός πλήρους κόμβου Zcash.
Από προεπιλογή, το BTCPay Server συνδέεται σε έναν δημόσιο κόμβο lightwalletd για να χειρίζεται θωρακισμένες πληρωμές χωρίς να κατεβάζει ολόκληρο το blockchain.
Το προεπιλεγμένο endpoint είναι:
https://zec.rocks:443
Ωστόσο, μπορείς να ρυθμίσεις το BTCPay Server ώστε να συνδέεται σε οποιονδήποτε εξωτερικό κόμβο lightwalletd, όπως:
https://lightwalletd.example:443
Αυτή η ενότητα δείχνει πώς να το κάνεις χρησιμοποιώντας ένα προσαρμοσμένο τμήμα Docker.
Ένα πλήρες παράδειγμα διαμόρφωσης με όλες τις μεταβλητές περιβάλλοντος είναι διαθέσιμο στο αποθετήριο του plugin.
Τα παρακάτω βήματα δείχνουν μια ελάχιστη λειτουργική ρύθμιση.
Βήμα 1: Δημιούργησε ένα προσαρμοσμένο τμήμα Docker
Στον κατάλογο του έργου BTCPayServer, δημιούργησε ένα προσαρμοσμένο αρχείο τμήματος:
Code-highlight
cd ~/BTCPayServer/btcpayserver-docker
mkdir -p docker-compose-generator/docker-fragments
nano docker-compose-generator/docker-fragments/zcash-lightwalletd.custom.yml
Πρόσθεσε το ακόλουθο περιεχόμενο:
Code-highlight
exclusive:
- zcash
Η οδηγία exclusive διασφαλίζει ότι μόνο ένα τμήμα με την ίδια ετικέτα (το zcash σε αυτή την περίπτωση) μπορεί να είναι ενεργό κάθε φορά.
Αυτό αποτρέπει διενέξεις διαμόρφωσης - για παράδειγμα, δεν μπορείς να εκτελείς ταυτόχρονα το τμήμα zcash-fullnode και αυτό το προσαρμοσμένο εξωτερικό τμήμα lightwalletd.
Σημειώνοντάς το ως exclusive: zcash, το BTCPay Server θα απενεργοποιεί αυτόματα τα προεπιλεγμένα containers zcash-fullnode και εσωτερικού lightwalletd, επιτρέποντάς σου να συνδεθείς στον δικό σου εξωτερικό κόμβο.
Βήμα 2: Όρισε μεταβλητές περιβάλλοντος
Στο τερματικό:
Code-highlight
export BTCPAYGEN_EXCLUDE_FRAGMENTS="$BTCPAYGEN_EXCLUDE_FRAGMENTS;zcash"
export BTCPAYGEN_ADDITIONAL_FRAGMENTS="$BTCPAYGEN_ADDITIONAL_FRAGMENTS;zcash-lightwalletd.custom"
Βήμα 3: Όρισε τη διεύθυνση του εξωτερικού κόμβου
Άνοιξε το αρχείο σου .env:
nano .env
Πρόσθεσε την ακόλουθη γραμμή, αντικαθιστώντας το URL με το endpoint που επέλεξες:
ZCASH_LIGHTWALLETD=https://lightwalletd.example:443
Μπορείς να χρησιμοποιήσεις:
- Έναν δημόσιο κόμβο, όπως το
https://zec.rocks:443
- Τον δικό σου self-hosted κόμβο, που έχει αναπτυχθεί ξεχωριστά από το BTCPay Server
Αν το εξωτερικό lightwalletd δεν είναι διαθέσιμο ή υπερφορτωθεί, οι θωρακισμένες πληρωμές θα αποτύχουν.
Για κρίσιμες υπηρεσίες, επίλεξε ένα σταθερό και δοκιμασμένο endpoint (όπως το προεπιλεγμένο zec.rocks).
Θέλεις να φιλοξενήσεις μόνος σου το lightwalletd;
Μπορείς να χρησιμοποιήσεις το docker-compose.lwd.yml από το αποθετήριο Zebra.
Προειδοποίηση: Αυτή η ρύθμιση δεν τεκμηριώνεται επίσημα και απαιτεί χειροκίνητη ρύθμιση TLS, προώθηση θυρών και διαμόρφωση firewall - συνιστάται μόνο για προχωρημένους χρήστες.
Βήμα 4: Εκτέλεσε ξανά το πρόγραμμα εγκατάστασης
. ./btcpay-setup.sh -i
Το BTCPay Server θα εφαρμόσει την προσαρμοσμένη διαμόρφωσή σου και θα συνδεθεί στον καθορισμένο κόμβο lightwalletd.
Από εδώ και στο εξής, το plugin Zcash θα χρησιμοποιεί αυτό το εξωτερικό endpoint για τη διαχείριση θωρακισμένων συναλλαγών.
Φιλοξενία του BTCPay Server στο σπίτι με Cloudflare Tunnel
Θέλεις να δέχεσαι πληρωμές Zcash ενώ φιλοξενείς το BTCPay Server σε μια οικιακή συσκευή - όπως ένα Raspberry Pi 5 ή οποιονδήποτε τοπικό διακομιστή χωρίς στατική IP;
Μπορείς να εκθέσεις με ασφάλεια την παρουσία σου στο διαδίκτυο χρησιμοποιώντας το Cloudflare Tunnel.
Αυτή η μέθοδος αποφεύγει την προώθηση θυρών και κρύβει την πραγματική διεύθυνση IP σου από το κοινό - ενώ διατηρεί τον διακομιστή σου προσβάσιμο μέσω HTTPS.
Σε βοηθά επίσης να αποφύγεις το κόστος ενοικίασης ενός VPS, κάτι ιδανικό αν οι πληρωμές σε κρυπτονομίσματα είναι προαιρετική λειτουργία και όχι ο πυρήνας της επιχείρησής σου.
Βήμα 1: Εγκατάστησε το Cloudflare Tunnel
- Δημιούργησε λογαριασμό στο cloudflare.com και πρόσθεσε το domain σου.
- Στον οικιακό διακομιστή σου, εγκατέστησε το Cloudflare Tunnel χρησιμοποιώντας το επίσημο αποθετήριο πακέτων του Cloudflare:
Code-highlight
sudo mkdir -p --mode=0755 /usr/share/keyrings
curl -fsSL https://pkg.cloudflare.com/cloudflare-main.gpg | sudo tee /usr/share/keyrings/cloudflare-main.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/cloudflare-main.gpg] https://pkg.cloudflare.com/cloudflared any main" | sudo tee /etc/apt/sources.list.d/cloudflared.list
sudo apt update
sudo apt install cloudflared
Αν το apt install cloudflared αποτύχει, εγκατάστησε το αντίστοιχο .deb:
Code-highlight
# Raspberry Pi / ARM64
curl -L --output cloudflared.deb https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-arm64.deb
sudo dpkg -i cloudflared.deb
Code-highlight
# x86_64
curl -L --output cloudflared.deb https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb
sudo dpkg -i cloudflared.deb
- Πιστοποιήσου στο Cloudflare:
cloudflared tunnel login
Αυτή η εντολή θα ανοίξει ένα παράθυρο browser. Συνδέσου και εξουσιοδότησε την πρόσβαση στο domain σου.
Το Cloudflare θα δημιουργήσει αυτόματα ένα αρχείο credentials με ένα token στον διακομιστή σου.
- Δημιούργησε ένα νέο tunnel (μπορείς να το ονομάσεις
btcpay ή όπως αλλιώς θέλεις):
cloudflared tunnel create btcpay
Αυτό δημιουργεί ένα αρχείο btcpay.json που περιέχει το αναγνωριστικό και τα διαπιστευτήρια του tunnel - θα το χρειαστείς στο επόμενο βήμα.
Βήμα 2: Δημιούργησε αρχείο διαμόρφωσης tunnel
Δημιούργησε τον κατάλογο διαμόρφωσης (αν δεν υπάρχει) και άνοιξε το αρχείο ρυθμίσεων:
Code-highlight
sudo mkdir -p /etc/cloudflared
sudo nano /etc/cloudflared/config.yml
Επικόλλησε την ακόλουθη διαμόρφωση:
Code-highlight
tunnel: btcpay # your tunnel name
credentials-file: /root/.cloudflared/btcpay.json
ingress:
- hostname: btcpay.example.com # your domain
service: http://127.0.0.1:80
- service: http_status:404
Επεξήγηση:
tunnel - όνομα του tunnel που δημιούργησες προηγουμένωςcredentials-file - διαδρομή προς το αρχείο token που δημιουργήθηκε κατά τη διάρκεια του cloudflared tunnel loginhostname - το domain σου που έχει καταχωριστεί στο Cloudflare (π.χ. btcpay.example.com)service - η τοπική διεύθυνση του BTCPay Server σου (συνήθως http://127.0.0.1:80 για το Nginx)
Το Cloudflare θα μεσολαβεί με ασφάλεια στην κίνηση προς τον τοπικό διακομιστή σου, χωρίς να εκθέτει την οικιακή IP σου.
Βήμα 3: Πρόσθεσε μια εγγραφή DNS για το tunnel σου
Αφού δημιουργήσεις το tunnel, το Cloudflare συνήθως προσθέτει αυτόματα μια εγγραφή CNAME DNS για το domain σου. Θα πρέπει να μοιάζει κάπως έτσι:
btcpay.example.com -> <UUID>.cfargotunnel.com
Αν δεν εμφανιστεί αυτόματα, πρόσθεσέ τη χειροκίνητα:
- Πήγαινε στο Cloudflare Dashboard σου
- Μετακινήσου στην ενότητα DNS
- Πρόσθεσε μια νέα εγγραφή CNAME:
Αυτή η εγγραφή διασφαλίζει ότι όλα τα αιτήματα προς το btcpay.example.com δρομολογούνται μέσω του Cloudflare Tunnel, κρύβοντας την πραγματική διεύθυνση IP σου από το κοινό.
Βήμα 4: Ενεργοποίησε το tunnel κατά την εκκίνηση του συστήματος
Για να εκτελείται αυτόματα το tunnel κατά την εκκίνηση, εγκατέστησέ το ως υπηρεσία συστήματος:
sudo cloudflared service install
Έπειτα ενεργοποίησε και εκκίνησε την υπηρεσία:
Code-highlight
sudo systemctl enable cloudflared
sudo systemctl start cloudflared
Έλεγξε την κατάστασή της:
sudo systemctl status cloudflared
Θα πρέπει να δεις ένα μήνυμα όπως Active: active (running) και επιβεβαίωση ότι το btcpay.example.com είναι online.
Από εδώ και στο εξής, το tunnel θα εκκινεί αυτόματα σε κάθε επανεκκίνηση και το BTCPay Server σου θα είναι δημόσια προσβάσιμο - χωρίς προώθηση θυρών και χωρίς να εκθέτεις την πραγματική IP σου.
Βήμα 5: Ολοκλήρωσε τη ρύθμιση του BTCPay Server
Αν πρόκειται να εγκαταστήσεις το BTCPay Server για πρώτη φορά, όρισε το domain σου πριν εκτελέσεις το script εγκατάστασης:
export BTCPAY_HOST="btcpay.example.com"
Αυτό διασφαλίζει ότι χρησιμοποιείται το σωστό domain κατά τη δημιουργία της διαμόρφωσης Nginx και των πιστοποιητικών SSL.
Αν το BTCPay Server είναι ήδη εγκατεστημένο και απλώς προσθέτεις το tunnel:
Code-highlight
cd ~/BTCPayServer/btcpayserver-docker
. ./btcpay-setup.sh -i
Η ρύθμιση θα δημιουργήσει ξανά τις διαμορφώσεις και θα εφαρμόσει το νέο domain.
Θα πρέπει τώρα να μπορείς να προσπελάσεις τον διακομιστή σου στο:
https://btcpay.example.com
Είτε χρησιμοποιείς έναν δημόσιο lightwalletd είτε τον δικό σου πλήρη κόμβο, αυτό δεν επηρεάζει το tunnel.
Το μόνο που έχει σημασία είναι ότι το BTCPay Server ακούει τοπικά στο 127.0.0.1:80.
Ρύθμιση του plugin Zcash στη διαδικτυακή διεπαφή BTCPay Server
Σημαντικό για ρυθμίσεις πολλών καταστημάτων:
Το πορτοφόλι Zcash που ρυθμίζεται εδώ είναι καθολικό για την παρουσία. Όλα τα καταστήματα θα χρησιμοποιούν αυτό το πορτοφόλι, εκτός αν εκτελείς ξεχωριστές παρουσίες BTCPay.
Αφού αναπτύξεις με επιτυχία την παρουσία BTCPay Server, θα χρειαστεί να εκτελέσεις ορισμένες βασικές ρυθμίσεις μέσω της διαδικτυακής διεπαφής διαχειριστή.
Η επίσημη τεκμηρίωση παρέχει πλήρεις οδηγίες στα Αγγλικά - εδώ θα εξετάσουμε τα βασικά βήματα και θα επικεντρωθούμε ειδικά στη ρύθμιση του plugin Zcash.
Βήμα 1: Συνδέσου στη διαδικτυακή διεπαφή
Επισκέψου την παρουσία σου στο:
[https://btcpay.example.com](https://btcpay.example.com)
- Εισήγαγε το όνομα σύνδεσης και τον κωδικό πρόσβασης διαχειριστή.
- Αν είναι η πρώτη φορά που συνδέεσαι, θα σου ζητηθεί να δημιουργήσεις λογαριασμό.
- Ο πρώτος λογαριασμός που καταχωρίζεις θα λάβει αυτόματα δικαιώματα διαχειριστή.
Βήμα 2: Εγκατάστησε το plugin Zcash
- Στο κύριο μενού, πήγαινε στο:
Plugins -> Browse Plugins
- Εντόπισε το plugin Zcash (ZEC). Χρησιμοποίησε τη γραμμή αναζήτησης αν χρειάζεται.
- Κάνε κλικ στο Install και επιβεβαίωσε.
Επανάλαβε αυτή τη διαδικασία για οποιαδήποτε άλλα altcoins ενεργοποίησες κατά τη διαμόρφωση του διακομιστή.
Μετά την εγκατάσταση, κάνε κλικ στο Restart Server για να επαναφορτώσεις τη διεπαφή με τα ενεργά plugins.
Βήμα 3: Σύνδεσε το πορτοφόλι σου μέσω Viewing Key
Μετά την εγκατάσταση του plugin, θα εμφανιστεί μια νέα ενότητα Zcash στο μενού ρυθμίσεων.
- Πήγαινε στο:
Zcash -> Settings
- Επικόλλησε το Unified Full Viewing Key (UFVK) σου - το BTCPay θα παράγει μια ενοποιημένη διεύθυνση για κάθε τιμολόγιο και θα εντοπίζει εισερχόμενες θωρακισμένες πληρωμές.
Σημείωση: Τα legacy viewing keys Sapling υποστηρίζονται, αλλά για να χρησιμοποιήσεις Orchard/ενοποιημένες διευθύνσεις θα πρέπει να παρέχεις ένα UFVK.
Παράδειγμα μορφής:
uview184syv9wftwngkay8d...
- Εισήγαγε μια τιμή στο πεδίο Block height
- Ρύθμιση για πρώτη φορά με νέο πορτοφόλι (νέα φράση ανάκτησης): εισήγαγε το τρέχον ύψος μπλοκ Zcash (μπορείς να το ελέγξεις στο 3xpl.com/zcash) - αυτό επιταχύνει την αρχική σάρωση.
- Μεταφορά στον ίδιο διακομιστή από μια legacy ρύθμιση μόνο με Sapling σε ενοποιημένες διευθύνσεις / Orchard: άφησε αυτό το πεδίο κενό.
- Μεταφορά του καταστήματός σου σε νέο διακομιστή με το ίδιο πορτοφόλι/UFVK: προαιρετικά εισήγαγε το ύψος γέννησης - ένα κατά προσέγγιση ύψος της πρώτης πληρωμένης παραγγελίας του καταστήματός σου (ταίριαξε την ημερομηνία παραγγελίας στο 3xpl για να περιορίσεις τη σάρωση). Αν δεν είσαι βέβαιος, άφησέ το κενό.
Δεν υποστηρίζουν ακόμη όλα τα πορτοφόλια την εξαγωγή Unified Full Viewing Key (UFVK).
Προτεινόμενες επιλογές:
– Zkool
– Zingo! Wallet (έκδοση για PC)
Και στις δύο εφαρμογές, αναζήτησε την εξαγωγή UFVK στην ενότητα backup/export.
Αυτά τα κλειδιά υποστηρίζουν αυτόματη εναλλαγή διευθύνσεων, που σημαίνει:
- Κάθε πελάτης λαμβάνει μια μοναδική διεύθυνση πληρωμής
- Βλέπεις ένα ενιαίο, ενοποιημένο υπόλοιπο
Μπορείς να βρεις μια ευρύτερη λίστα συμβατότητας στο ZecHub -> Wallets.
Μόλις συμπληρωθούν όλα τα πεδία, κάνε κλικ στο Save.
Δοκίμασε τη ροή πληρωμών ZEC
Συγχαρητήρια - το πορτοφόλι σου Zcash είναι τώρα συνδεδεμένο με το BTCPay Server.
Ας κάνουμε μια δοκιμή:
- Πήγαινε στο:
Invoices -> Create New
- Δημιούργησε ένα δοκιμαστικό τιμολόγιο για ένα μικρό ποσό σε ZEC.
- Στείλε κεφάλαια από διαφορετικό πορτοφόλι (όχι από αυτό που είναι συνδεδεμένο στο BTCPay).
- Μόλις εντοπιστεί η συναλλαγή, η σελίδα τιμολογίου θα εμφανίσει έναν οπτικό εορτασμό.
- Επιβεβαίωσε ότι η κατάσταση του τιμολογίου αλλάζει σε Paid.
Αν όλα λειτουργούν - είσαι έτοιμος να ενσωματώσεις πληρωμές ZEC στον ιστότοπό σου χρησιμοποιώντας το API ή plugins CMS.
Ενσωμάτωση του BTCPay Server στον ιστότοπό σου
Μόλις το πορτοφόλι σου Zcash συνδεθεί με το BTCPay Server, μπορείς να ενσωματώσεις το σύστημα πληρωμών στον ιστότοπό σου.
Υπάρχουν αρκετοί τρόποι να το κάνεις - από άμεση πρόσβαση API έως έτοιμα plugins για δημοφιλείς πλατφόρμες CMS.
Επιλογές ενσωμάτωσης
-
Ενσωμάτωση API
Ιδανική για προσαρμοσμένους ιστότοπους ή συστήματα χωρίς CMS.
Σου δίνει πλήρη έλεγχο για τη δημιουργία τιμολογίων, την παρακολούθηση πληρωμών και τις ειδοποιήσεις - όλα μέσα στη δική σου διεπαφή και λογική.
Απαιτεί βασικές γνώσεις προγραμματισμού, επομένως αυτή η εργασία είναι καλύτερο να ανατεθεί στον προγραμματιστή σου.
-
Plugins CMS
Διαθέσιμα για πλατφόρμες όπως το WooCommerce, το PrestaShop και άλλες.
Αυτά τα plugins σου επιτρέπουν να δέχεσαι πληρωμές σε λίγα μόλις λεπτά - χωρίς να απαιτείται κώδικας.
-
Κουμπί πληρωμής ή Iframe
Η απλούστερη μέθοδος.
Ιδανική για landing pages, προσωπικούς ιστότοπους ή οποιονδήποτε ιστότοπο όπου θέλεις απλώς να ενσωματώσεις έναν σύνδεσμο δωρεάς ή widget checkout.
Ενσωμάτωση API
Αν χρησιμοποιείς μια προσαρμοσμένη πλατφόρμα (ή δεν χρησιμοποιείς καθόλου CMS), το API είναι η καλύτερη επιλογή.
Σου δίνει πλήρη ευελιξία: μπορείς να δημιουργείς τιμολόγια, να παρακολουθείς την κατάστασή τους, να λαμβάνεις ειδοποιήσεις και να ελέγχεις πλήρως την εμπειρία χρήστη.
Σημείωση: Ακόμη και ορισμένα plugins CMS χρησιμοποιούν το API παρασκηνιακά, επομένως η δημιουργία ενός κλειδιού API είναι συχνά το πρώτο απαιτούμενο βήμα, ανεξάρτητα από τη μέθοδο ενσωμάτωσής σου.
Επόμενο βήμα: δημιούργησε ένα κλειδί API για το κατάστημά σου και ξεκίνα να χρησιμοποιείς το Greenfield API για να δημιουργήσεις την ενσωμάτωσή σου.
Δημιουργία κλειδιού API
Για να ενσωματώσεις το BTCPay Server στον ιστότοπο ή την εφαρμογή σου, θα χρειαστεί να δημιουργήσεις ένα κλειδί API.
-
Συνδέσου στο BTCPay Server και άνοιξε το μενού χρήστη (επάνω δεξιά γωνία)
-
Πήγαινε στο API Keys
-
Κάνε κλικ στο Create a new API key
-
Εισήγαγε ένα όνομα για το κλειδί σου
-
Στην ενότητα Permissions, ενεργοποίησε:
Can create invoiceCan view invoice- (Προαιρετικό)
Can modify store settings - μόνο αν χρειάζεσαι διαχείριση σε επίπεδο καταστήματος
-
Κάνε κλικ στο Generate. Θα εμφανιστεί το προσωπικό κλειδί API σου - αντέγραψέ το και αποθήκευσέ το με ασφάλεια.
Αυτό το κλειδί παρέχει πρόσβαση στα τιμολόγια του καταστήματός σου.
Μην το κοινοποιείς δημόσια και μην το εκθέτεις σε client-side κώδικα.
Παράδειγμα: Δημιουργία τιμολογίου μέσω API
Endpoint:
Code-highlight
POST /api/v1/stores/{storeId}/invoices
Authorization: token {apiKey}
Content-Type: application/json
Σώμα αιτήματος:
Code-highlight
{
"amount": 5,
"currency": "ZEC",
"checkout": {
"speedPolicy": "HighSpeed",
"paymentMethods": ["Zcash"]
}
}
Απόκριση:
Θα λάβεις ένα αντικείμενο JSON με:
invoiceId- Ένα URL πληρωμής που μπορείς να ενσωματώσεις στον ιστότοπό σου ή να στείλεις στον πελάτη
Δες την πλήρη τεκμηρίωση:
Greenfield API – Create Invoice
Ρύθμιση Webhook (προαιρετικό)
Για να λαμβάνεις ειδοποιήσεις σε πραγματικό χρόνο όταν αλλάζουν οι καταστάσεις τιμολογίων (π.χ. όταν λαμβάνεται μια πληρωμή):
- Πήγαινε στις ρυθμίσεις του καταστήματός σου -> Webhooks
- Πρόσθεσε το URL του endpoint backend σου που θα χειρίζεται αιτήματα
POST από το BTCPay Server
- Το BTCPay θα στέλνει αυτόματα ειδοποιήσεις όταν ένα τιμολόγιο πληρώνεται ή λήγει
Τα payloads του webhook και η λογική επανάληψης περιγράφονται στην επίσημη τεκμηρίωση webhook.
Παραδείγματα ενσωμάτωσης είναι διαθέσιμα για διάφορες γλώσσες προγραμματισμού στα έγγραφα BTCPay και στα αποθετήρια GitHub.
Ενσωμάτωση CMS
Το BTCPay Server υποστηρίζει plugins για δημοφιλή συστήματα διαχείρισης περιεχομένου (CMS).
Η πιο ώριμη και ευρέως χρησιμοποιούμενη ενσωμάτωση είναι με το WordPress + WooCommerce, καθιστώντας εύκολη την αποδοχή πληρωμών ZEC χωρίς να γράψεις κώδικα.
WooCommerce (WordPress)
Το BTCPay Server υποστηρίζει επίσημα ένα plugin για το WooCommerce.
Βήματα ενσωμάτωσης:
- Εγκατάστησε το plugin BTCPay for WooCommerce από τον κατάλογο plugins του WordPress ή από το GitHub.
- Στον πίνακα διαχειριστή WordPress, πήγαινε στο:
WooCommerce -> Settings -> Payments
- Βρες το BTCPay στη λίστα και κάνε κλικ στο Set up
- Εισήγαγε το URL BTCPay Server σου και ακολούθησε τις οδηγίες εξουσιοδότησης
(συνιστάται η αυτόματη δημιουργία κλειδιού API)
- Ενεργοποίησε τη μέθοδο πληρωμής και αποθήκευσε τις ρυθμίσεις σου
Λεπτομερείς οδηγίες, βίντεο με οδηγίες και οδηγοί αντιμετώπισης προβλημάτων είναι διαθέσιμα στην τεκμηρίωση του plugin.
Θα βρεις επίσης άλλες επιλογές ενσωμάτωσης CMS στην ίδια ενότητα των εγγράφων BTCPay.
Κουμπί πληρωμής ή Iframe (δεν χρειάζεται CMS ή API)
Αν δεν χρησιμοποιείς CMS και δεν θέλεις να εργαστείς με APIs, ο ευκολότερος τρόπος να δέχεσαι πληρωμές ZEC είναι να ενσωματώσεις έναν σύνδεσμο πληρωμής ή widget απευθείας στον ιστότοπό σου.
Αυτή η μέθοδος είναι ιδανική για:
- Landing pages
- Ιστότοπους portfolio
- Blogs ή στατικές σελίδες
- Έργα χωρίς διακομιστή backend
Επιλογή 1: Κουμπί πληρωμής (σύνδεσμος)
- Στο BTCPay Server, δημιούργησε χειροκίνητα ένα τιμολόγιο στην ενότητα Invoices
- Αντέγραψε τον σύνδεσμο πληρωμής, π.χ.:
[https://btcpay.example.com/i/abc123](https://btcpay.example.com/i/abc123)
- Πρόσθεσε τον σύνδεσμο στο HTML σου:
Code-highlight
<a href="https://btcpay.example.com/i/abc123" target="_blank">
Pay with ZEC
</a>
Επιλογή 2: Ενσωματωμένο τιμολόγιο (Iframe)
Για να εμφανίσεις το τιμολόγιο απευθείας στον ιστότοπό σου, χρησιμοποίησε ένα iframe:
<iframe src="https://btcpay.example.com/i/abc123" width="600" height="350" frameborder="0"></iframe>
Μπορείς να διαμορφώσεις το κουμπί ή το container του iframe ώστε να ταιριάζει με τον σχεδιασμό του ιστότοπού σου - το BTCPay Server επιτρέπει ευέλικτη θεματοποίηση της σελίδας τιμολογίου.
Συμπέρασμα
Αυτός ο οδηγός ήταν μακρύς - αλλά καλύπτει μόνο τις θεμελιώδεις πτυχές της ενσωμάτωσης πληρωμών Zcash με το BTCPay Server.
Η διεπαφή BTCPay Server προσφέρει πολύ περισσότερες λειτουργίες από όσες δείξαμε εδώ. Ευτυχώς, το UI είναι διαθέσιμο σε πολλές γλώσσες (συμπεριλαμβανομένων των ρωσικών), καθιστώντας εύκολη την περαιτέρω εξερεύνηση και τον πειραματισμό.
Το BTCPay είναι ένα εξαιρετικά ευέλικτο εργαλείο. Μπορείς να:
- Φιλοξενείς πολλά ανεξάρτητα καταστήματα σε μία μόνο εγκατάσταση
- Ορίζεις προσαρμοσμένους ρόλους και δικαιώματα για τα μέλη της ομάδας - από προβολή μόνο παραγγελιών έως πλήρη διαχείριση
- Χρησιμοποιείς τα δικά σου domains και branding
- Ρυθμίζεις webhooks, εφεδρικά πορτοφόλια και ακόμη και πρόσβαση Tor
- Διαμορφώνεις προηγμένες ρυθμίσεις, όπως φορολογικούς κανόνες, κωδικούς έκπτωσης, προσαρμογή της σελίδας ολοκλήρωσης αγοράς, περιορισμούς μεθόδων πληρωμής και άλλα
Το BTCPay δημιουργήθηκε ως μια εναλλακτική ανοιχτού κώδικα στους κεντρικοποιημένους παρόχους πληρωμών. Αν θέλεις να δέχεσαι ιδιωτικές πληρωμές ZEC χωρίς μεσάζοντες, αυτή η πλατφόρμα αξίζει απολύτως την προσοχή σου.
Σου ευχόμαστε επιτυχία στην εξερεύνηση του οικοσυστήματος BTCPay και στο να κάνεις τις πληρωμές σου πραγματικά δικές σου.
Πόροι
