Den här guiden förklarar hur du ställer in Bitcoin-betalningar på din webbplats med hjälp av Electrum. Vi kommer att använda SSL-signerade betalningsförfrågningar, enligt BIP-70 standard. Denna dokumentation är aktuell för Electrum 4.0 och senare.
Innan du börjar, se till att du har:
- Ett giltigt SSL-certifikat (CA-signerat, t.ex. det kostnadsfria LetsEncrypt).
- Utvecklingsversionen av Electrum installerad.
Kom ihåg att köra kommandot submodule update under installationen.
Konfigurera ditt SSL-certifikat i Electrum
För att aktivera säkra anslutningar måste du lägga till ditt SSL-certifikat i Electrum. Använd dessa kommandon i din terminal:
electrum -o setconfig ssl_keyfile /path/to/ssl/privkey.pem
electrum -o setconfig ssl_certfile /path/to/ssl/fullchain.pem
För mer detaljerade instruktioner om hur du lägger till SSL i Electrum, se Konfigurera SSL för Electrum.
Skapa och använda din Merchant Wallet
Sätt upp en säker plånbok för dina affärstransaktioner. Denna process hjälper till att skydda din kryptovaluta även om din handelsserver äventyras.
- Skapa en ny plånbok
Skapa en ny plånbok på en säker dator:
electrum create
Det är bäst att använda en separat plånbok för ditt företag, inte din personliga plånbok.
- Exportera den offentliga huvudnyckeln
Exportera den offentliga huvudnyckeln (xpub) på din säkra dator:
electrum getmpk -w .electrum/wallets/your-wallet
- Konfigurera Merchant Server
På din servermaskin återställer du plånboken med hjälp av den exporterade Master Public Key:
electrum restore xpub...............................................
Byt ut xpub... med din faktiska Master Public Key
- Konfigurera serverinställningar.
electrum -o setconfig payserver_address yourdomain.com:80
Byt ut yourdomain.com med din faktiska domän.
Starta Electrum Daemon
När du har konfigurerat din skrivskyddade plånbok måste du köra Electrum som en bakgrundstjänst. Så här gör du:
- Starta Daemon
Kör detta kommando för att starta Electrum som en daemon:
electrum daemon -d
Detta startar Electrum i daemonläge, vilket gör att det kan köras i bakgrunden.
- Ladda din plånbok
Ladda sedan in din plånbok i den körande daemon:
electrum load_wallet
Detta kommando gör din plånbok aktiv och redo att användas.
Stoppa Daemon
Om du behöver stoppa Electrum-daemon vid något tillfälle använder du det här kommandot:
electrum stop
Detta kommer att stänga av Electrums daemon på ett säkert sätt.
Skapa en signerad betalningsbegäran
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"
}
Här följer en sammanställning av den viktigaste informationen:
URI: En Bitcoin-URI som innehåller belopp, meddelande, tidsstämpel och utgångsdatum.address: Bitcoin-adressen för betalningen.amount: Det begärda beloppet i satoshis.amount_BTC: Det begärda beloppet i BTC.bip70_url: URL-adressen till den signerade BIP70-begäran.view_url: URL:en till en webbsida som visar begäran.
Kommandoutmatningen innehåller två viktiga webbadresser:
bip70_url: Detta är webbadressen till den undertecknade BIP70-begäran.view_url: Detta är URL:en till en webbsida som visar detaljer om begäran.
För att visa din aktuella lista över förfrågningar använder du list_requests kommando.
Om du vill ta bort alla begäranden från listan använder du clear_requests kommando.
Öppna sidan för betalningsbegäran i din webbläsare
När du har skapat en betalningsbegäran kan du visa den i en webbläsare.
Så här använder du sidan för betalningsbegäran:
- Öppna
view_urlfrån betalningsbegäran som visas i din webbläsare. - Sidan kommer att visa detaljerna för betalningsbegäran, inklusive:
- En Bitcoin-URI som kan öppnas med en plånbok.
- En QR-kod som kan skannas för betalning.
- Den återstående tiden tills begäran löper ut.
- För att göra en betalning:
- Använd en Bitcoin-plånbok för att öppna den tillhandahållna Bitcoin URI:n.
- Skanna QR-koden med en mobil plånbok.
- Sidan använder websockets för att uppdateras i realtid. När betalningen tas emot uppdateras sidan automatiskt för att visa den uppdaterade statusen.
Det faktiska utseendet på sidan kan variera, men den kommer att innehålla den väsentliga information som behövs för att slutföra betalningen.
Viktigt: Kontrollera alltid betalningsuppgifterna innan du skickar några pengar.
Blixtsnabba betalningar
Konfigurera blixtnedslag
För att kunna använda Lightning måste du konfigurera Lightning-nycklar i din plånbok. Följ dessa steg:
- Stoppa Electrum-daemon:
electrum stop - Initialisera blixtnycklar:
electrum -o init_lightning - Starta om daemon:
electrum daemon -d
Du kan lägga till Lightning-nycklar i en plånbok som endast övervakas. Den här plånboken kan inte spendera mynt på kedjan, men den kan utföra Lightning-transaktioner.
Öppna en kanal
När du har konfigurerat Lightning måste du öppna en kanal:
electrum open_channel <node_id> <amount>
För att kontrollera om kanalen är klar för användning:
electrum list_channels
Observera att din nya kanal inte kommer att ha inkommande kapacitet till en början, så du kan inte ta emot betalningar omedelbart. Om du behöver ta emot betalningar direkt kan du överväga att göra en submarin swap av dina kanalfonder.
Skapa en betalningsbegäran med Lightning
För att skapa en Lightning-betalningsförfrågan:
electrum add_lightning_request 0.0001 -m "test"
Detta kommando skapar en begäran om 0,0001 BTC med meddelandet "test".