이 가이드에서는 Electrum을 사용하여 웹사이트에서 비트코인 결제를 설정하는 방법을 설명합니다. 저희는 SSL 서명 결제 요청을 사용합니다. BIP-70 표준을 따릅니다. 이 문서는 Electrum 4.0 이상 버전에 대한 최신 문서입니다.
시작하기 전에 다음 사항을 확인하세요:
- 유효한 SSL 인증서(CA 서명된 무료 LetsEncrypt).
- Electrum의 개발 버전이 설치되었습니다.
설치하는 동안 서브모듈 업데이트 명령을 실행하는 것을 잊지 마세요.
Electrum에서 SSL 인증서 설정
보안 연결을 사용하려면 SSL 인증서를 Electrum에 추가해야 합니다. 터미널에서 다음 명령을 사용하세요:
electrum -o setconfig ssl_keyfile /path/to/ssl/privkey.pem
electrum -o setconfig ssl_certfile /path/to/ssl/fullchain.pem
Electrum에 SSL을 추가하는 방법에 대한 자세한 지침은 다음을 확인하세요. Electrum용 SSL 구성.
판매자 지갑 생성 및 사용
비즈니스 거래를 위한 보안 지갑을 설정하세요. 이 프로세스는 판매자 서버가 손상되더라도 암호화폐를 보호하는 데 도움이 됩니다.
- 새 지갑 만들기
보안이 설정된 컴퓨터에서 새 지갑을 만듭니다:
electrum create
개인 지갑이 아닌 비즈니스용 지갑을 별도로 사용하는 것이 가장 좋습니다.
- 마스터 공개 키 내보내기
보안 컴퓨터에서 마스터 공개 키(xpub)를 내보냅니다:
electrum getmpk -w .electrum/wallets/your-wallet
- 판매자 서버 설정
서버 컴퓨터에서 내보낸 마스터 공개 키를 사용하여 지갑을 복원합니다:
electrum restore xpub...............................................
교체 xpub...
실제 마스터 공개 키로
- 서버 설정을 구성합니다.
electrum -o setconfig payserver_address yourdomain.com:80
교체 yourdomain.com
를 실제 도메인으로 변경합니다.
일렉트럼 데몬 시작
읽기 전용 지갑을 설정한 후에는 Electrum을 백그라운드 서비스로 실행해야 합니다. 방법은 다음과 같습니다:
- 데몬 시작
이 명령을 실행하여 일렉트럼을 데몬으로 시작합니다:
electrum daemon -d
이렇게 하면 일렉트럼이 데몬 모드로 실행되어 백그라운드에서 실행할 수 있습니다.
- 지갑 로드
다음으로 실행 중인 데몬에 지갑을 로드합니다:
electrum load_wallet
이 명령을 실행하면 지갑이 활성화되어 사용할 준비가 됩니다.
데몬 중지하기
언제든지 Electrum 데몬을 중지해야 하는 경우 이 명령을 사용하세요:
electrum stop
이렇게 하면 일렉트럼 데몬이 안전하게 종료됩니다.
서명된 결제 요청 만들기
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"
}
다음은 주요 정보에 대한 분석입니다:
URI
: 금액, 메시지, 타임스탬프, 만료일을 포함하는 비트코인 URI입니다.address
: 결제를 위한 비트코인 주소입니다.amount
: 사토시 단위로 요청된 금액입니다.amount_BTC
: 요청 금액(BTC)입니다.bip70_url
: 서명된 BIP70 요청의 URL입니다.view_url
: 요청을 표시하는 웹페이지의 URL입니다.
명령 출력에는 두 개의 중요한 URL이 포함되어 있습니다:
bip70_url
: 서명된 BIP70 요청의 URL입니다.view_url
: 요청 세부 정보를 표시하는 웹페이지의 URL입니다.
현재 요청 목록을 보려면 list_requests
명령을 사용합니다.
목록에서 모든 요청을 제거하려면 clear_requests
명령을 사용합니다.
브라우저에서 결제 요청 페이지를 엽니다.
결제 요청을 생성한 후 웹 브라우저에서 확인할 수 있습니다.

결제 요청 페이지를 사용하는 방법은 다음과 같습니다:
- 열기
view_url
를 웹 브라우저의 결제 요청 출력에 표시합니다. - 페이지에 결제 요청 세부 정보가 표시됩니다:
- 지갑으로 열 수 있는 비트코인 URI입니다.
- 결제 시 스캔할 수 있는 QR 코드입니다.
- 요청이 만료될 때까지 남은 시간입니다.
- 결제하기:
- 비트코인 지갑을 사용하여 제공된 비트코인 URI를 엽니다.
- 모바일 지갑으로 QR 코드를 스캔합니다.
- 이 페이지는 웹소켓을 사용하여 실시간으로 업데이트됩니다. 결제가 접수되면 페이지가 자동으로 새로고침되어 업데이트된 상태가 표시됩니다.

페이지의 실제 모양은 다를 수 있지만 결제를 완료하는 데 필요한 필수 정보가 포함되어 있습니다.
중요: 송금하기 전에 항상 결제 세부 정보를 확인하세요.
라이트닝 결제
라이트닝 설정
라이트닝을 사용하려면 지갑에 라이트닝 키를 설정해야 합니다. 다음 단계를 따르세요:
- 일렉트럼 데몬을 중지합니다:
electrum stop
- 라이트닝 키를 초기화합니다:
electrum -o init_lightning
- 데몬을 다시 시작합니다:
electrum daemon -d
보기 전용 지갑에 라이트닝 키를 추가할 수 있습니다. 이 지갑은 온체인에서 코인을 사용할 수는 없지만 라이트닝 트랜잭션을 수행할 수 있습니다.
채널 열기
라이트닝을 설정한 후에는 채널을 열어야 합니다:
electrum open_channel <node_id> <amount>
채널을 사용할 준비가 되었는지 확인하려면 다음과 같이 하세요:
electrum list_channels
새 채널에는 처음에는 인바운드 용량이 없으므로 즉시 정산금을 받을 수 없습니다. 즉시 수령해야 하는 경우 채널 자금을 잠수함 스왑하는 방법을 고려하세요.
라이트닝 결제 요청 생성
라이트닝 결제 요청을 생성하려면 다음과 같이 하세요:
electrum add_lightning_request 0.0001 -m "test"
이 명령은 "test" 메시지와 함께 0.0001 BTC에 대한 요청을 생성합니다.