Deze handleiding legt uit hoe u Bitcoin-betalingen kunt instellen op uw website met Electrum. We gebruiken SSL-ondertekende betalingsverzoeken, volgens de BIP-70 standaard. Deze documentatie is actueel voor Electrum 4.0 en hoger.
Voordat je begint, moet je ervoor zorgen dat je:
- Een geldig SSL-certificaat (CA-ondertekend, zoals het gratis LetsEncrypt).
- De ontwikkelversie van Electrum geïnstalleerd.
Vergeet niet om het submodule update commando uit te voeren tijdens de installatie.
Uw SSL-certificaat instellen in Electrum
Om beveiligde verbindingen mogelijk te maken, moet je je SSL-certificaat toevoegen aan Electrum. Gebruik deze commando's in uw terminal:
electrum -o setconfig ssl_keyfile /path/to/ssl/privkey.pem
electrum -o setconfig ssl_certfile /path/to/ssl/fullchain.pem
Voor meer gedetailleerde instructies over het toevoegen van SSL aan Electrum, bekijk de SSL configureren voor Electrum.
Uw Merchant Wallet aanmaken en gebruiken
Stel een beveiligde portemonnee in voor je zakelijke transacties. Dit proces helpt je cryptocurrency te beschermen, zelfs als je zakelijke server gecompromitteerd is.
- Een nieuwe portemonnee aanmaken
Maak op een beveiligde computer een nieuwe portemonnee aan:
electrum create
Je kunt het beste een aparte portemonnee voor je bedrijf gebruiken, niet je persoonlijke.
- De openbare sleutel exporteren
Exporteer de Master Public Key (xpub) nog steeds op uw beveiligde computer:
electrum getmpk -w .electrum/wallets/your-wallet
- De Merchant Server instellen
Herstel de portemonnee op je servermachine met de geëxporteerde openbare sleutel:
electrum restore xpub...............................................
vervangen xpub... met je actuele openbare sleutel
- Serverinstellingen configureren.
electrum -o setconfig payserver_address yourdomain.com:80
vervangen yourdomain.com met je eigenlijke domein.
De Electrum-daemon starten
Na het instellen van je alleen-lezen portemonnee, moet je Electrum als achtergronddienst draaien. Zo werkt het:
- De daemon starten
Voer dit commando uit om Electrum als daemon te starten:
electrum daemon -d
Dit start Electrum in daemon-modus, waardoor het op de achtergrond kan draaien.
- Laad je portemonnee
Laad vervolgens je portemonnee in de draaiende daemon:
electrum load_wallet
Dit commando maakt je portemonnee actief en klaar voor gebruik.
De daemon stoppen
Als je de Electrum daemon op enig moment moet stoppen, gebruik dan dit commando:
electrum stop
Dit zal de Electrum daemon veilig afsluiten.
Een ondertekend betalingsverzoek aanmaken
electrum add_request 0.5 -m "test"
{
"URI": "bitcoin:bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z?amount=0.5&message=test&time=1589115653&exp=3600",
"address": "bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z",
"amount": 50000000,
"amount_BTC": "0.5",
"bip70_url": "https://yourdomain.com:80/bip70/bc1qyr5xx5jkue3k72sldm5xa0taqs3n2achupymz8.bip70",
"exp": 3600,
"id": "63822b69013",
"memo": "test",
"status": 0,
"status_str": "Expires in about 1 hour",
"time": 1589115653,
"type": 0,
"view_url": "https://yourdomain.com:80/r/pay?id=bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z"
}
Hier volgt een overzicht van de belangrijkste informatie:
URI: Een Bitcoin URI met het bedrag, bericht, tijdstempel en vervaldatum.address: Het Bitcoin-adres voor de betaling.amount: Het gevraagde bedrag in satoshis.amount_BTC: Het gevraagde bedrag in BTC.bip70_url: De URL van het ondertekende BIP70-verzoek.view_url: De URL van een webpagina die het verzoek weergeeft.
De uitvoer van het commando bevat twee belangrijke URL's:
bip70_url: Dit is de URL van het ondertekende BIP70-verzoek.view_url: Dit is de URL van een webpagina die de details van het verzoek weergeeft.
Gebruik de knop list_requests commando.
Gebruik de optie clear_requests commando.
Open de betaalverzoekpagina in uw browser
Nadat je een betalingsverzoek hebt aangemaakt, kun je dit bekijken in een webbrowser.
Zo gebruik je de pagina met betalingsverzoeken:
- Open de
view_urlvan de uitvoer van het betalingsverzoek in uw webbrowser. - De pagina toont de details van het betalingsverzoek, inclusief:
- Een Bitcoin URI die kan worden geopend met een portemonnee.
- Een QR-code die kan worden gescand om te betalen.
- De resterende tijd tot de aanvraag verloopt.
- Een betaling doen:
- Gebruik een Bitcoin-portemonnee om de Bitcoin URI te openen.
- Scan de QR-code met een mobiele portemonnee.
- De pagina maakt gebruik van websockets om in realtime bij te werken. Wanneer de betaling is ontvangen, wordt de pagina automatisch vernieuwd om de bijgewerkte status weer te geven.
De pagina kan er anders uitzien, maar bevat de essentiële informatie die nodig is om de betaling te voltooien.
Belangrijk: Controleer altijd de betalingsgegevens voordat je geld verstuurt.
Bliksem betalingen
Lightning instellen
Om Lightning te gebruiken, moet je Lightning-sleutels instellen in je portemonnee. Volg deze stappen:
- Stop de Electrum daemon:
electrum stop - Lightning-sleutels initialiseren:
electrum -o init_lightning - Start de daemon opnieuw:
electrum daemon -d
U kunt Lightning-sleutels toevoegen aan een portemonnee die alleen bewaakt wordt. Deze portemonnee kan geen munten on-chain uitgeven, maar kan wel Lightning-transacties uitvoeren.
Een kanaal openen
Nadat je Lightning hebt ingesteld, moet je een kanaal openen:
electrum open_channel <node_id> <amount>
Controleren of het kanaal klaar is voor gebruik:
electrum list_channels
Merk op dat je nieuwe kanaal in het begin geen inkomende capaciteit zal hebben, dus je kunt niet meteen betalingen ontvangen. Als je meteen moet ontvangen, overweeg dan een onderzeese ruil van je kanaalfondsen.
Een Lightning-betalingsverzoek maken
Een Lightning-betalingsverzoek maken:
electrum add_lightning_request 0.0001 -m "test"
Dit commando maakt een verzoek aan voor 0,0001 BTC met het bericht "test".