비트코인 라이트닝

Lightning 결제를 받으세요.

수신 지갑을 연결하고 스토어에서 켜면 고객이 Lightning QR 코드로 결제할 수 있어요.

공개 노드가 아니라 지갑 연결이 필요해요.

공개 Bitcoin 엔드포인트는 블록체인을 읽을 수 있지만 Lightning 결제를 대신 받을 수는 없어요. Lightning에는 청구서를 만들고 정산 상태를 알려주는 지갑이 필요해요.

내 구성	연결 방식	누가 관리하나요?
내 노드	HTTPS를 통한 LND 또는 호환 NWC 지갑	키, 채널, 유동성, 백업을 직접 관리해요.
운영 지원을 받는 자기 수탁 지갑	NWC, 예: 호스팅을 이용한 Alby Hub	서비스가 운영을 도와줘요. 키 제어권과 복구 접근 권한을 유지하는지 확인하세요.
수탁 계정	호환 제공업체의 NWC 연결	제공업체가 자금을 보관해요. 수수료, 계정 한도, 인증 요건은 제공업체에 따라 달라요.

NWC는 연결 프로토콜이며 자산 보관을 보장하지 않아요. 사업에 맞는 지갑 방식을 선택하세요. Wholly Crypto는 Lightning 자금을 보관하거나 노드를 설치하지 않아요.

내 LND 노드를 연결하세요.

열기 설정 → 체인 연결 → Lightning 연결. 선택할 항목: LND · HTTPS.
외부에서 접근 가능한 HTTPS REST 엔드포인트와 16진수 형식의 제한된 macaroon을 입력하세요. 청구서 읽기·쓰기와 다음을 허용하세요: info:read. 명령에 다음을 추가하세요: offchain:read 은 채널 잔액 표시를 원할 때만 허용하세요. 절대 사용하면 안 되는 항목: admin.macaroon 또는 자금 사용 권한을 부여하지 마세요.
LND가 자체 TLS 인증서를 쓰면 공개 PEM 인증서를 붙여 넣으세요. TLS 개인 키는 붙여 넣지 마세요. 노드 방화벽에서 판매자 VPS의 접근을 허용하세요.
연결을 사용할 수 있는 프로젝트를 선택하세요. 확인하고 저장한 뒤 새 청구서에 활성화하세요.

노드는 Bitcoin 메인넷과 동기화돼 있어야 해요. TLS 검증은 유지돼요. 공개 HTTPS 주소만 허용하며 사설, 루프백, 예약 주소는 차단해요. 노드는 결제 서버와 분리하세요.

LND macaroon 권한 ↗

Nostr Wallet Connect로 연결하세요.

Alby Hub 또는 호환 지갑에서 수신 전용 연결을 만드세요.
허용 make_invoice, lookup_invoice 및 get_info. get_balance 는 선택 사항이에요. 결제나 출금 메서드는 허용하지 마세요.
선택 Nostr Wallet Connect 를 Wholly Crypto에서 선택하고 다음의 전체 문자열을 붙여 넣으세요: nostr+walletconnect://… 연결 문자열이에요. 비밀번호처럼 보호하세요.
연결 문자열에 공개 WSS 릴레이 하나를 사용하세요. 자산 보관 방식과 프로젝트 접근 권한을 고른 뒤 확인하고 저장하세요.

Wholly Crypto는 서명된 응답을 검증하고 NIP-44 v2 암호화와 이전 NIP-04 호환을 지원해요. 지갑은 정산 증거를 포함한 수신 청구서 조회를 지원해야 해요. 모든 NWC 계정이 모든 수신 메서드를 지원하는 것은 아니에요.

Alby Hub 가이드 ↗ · NWC 명세 ↗

스토어에서 활성화하세요.

열기 프로젝트 → 스토어 → 결제 수단 → Bitcoin Lightning. 연결을 선택하고 켜세요. 온체인 Bitcoin은 별도 선택지이며 둘 중 하나 또는 둘 다 제공할 수 있어요.

수동 또는 일반 API로 소액 청구서를 만드세요. 결제 화면에서 Bitcoin을 고른 뒤 Bitcoin Lightning을 선택하세요. QR 코드를 스캔하거나 Lightning 지갑에서 요청을 여세요. 청구서를 만드는 데 새 API 경로는 필요 없어요.

결제 완료는 정산 완료를 뜻해요.

각 요청에는 고유 BOLT11 청구서와 결제 해시가 있어요. 가격은 스토어 법정화폐와 스프레드를 사용하며 사토시 정수로 올림해요. Wholly Crypto는 밀리사토시 정밀도로 수신을 기록해요.

보류되거나 감지된 결제만으로는 부족해요. 지갑이 유효한 결제 증거와 함께 정산을 보고해야 해요. 블록 확인은 필요 없어요. 청구서 기록, 처리 수수료, IPN, 웹훅은 일반 청구서 흐름을 따라요.

LND는 연결마다 정산 구독 하나와 복구 조회를 사용하고 NWC는 청구서 조회를 사용해요. 대기 중인 조회는 보통 약 10초마다 실행되지만 장애, 대기열, 제공업체 제한으로 늦어질 수 있어요. 미정산 요청은 판매자 청구서 기한 후 24시간 동안 모니터링해요.

인증 정보를 끄거나 바꿔도 기존 요청이 다른 지갑으로 옮겨지지 않아요. 대기 중인 요청이 끝날 때까지 기존 수신 인증 정보를 유지하세요. 만료되거나 취소된 요청에는 결제하면 안 돼요.

이 연동은 결제 수신용이에요. 전송, 환불, 채널 관리, 거래소 이체에는 연결한 지갑을 사용하세요. Lightning 잔액은 공유 지갑 잔액이며 프로젝트별 지갑이 아니에요. 제공업체, 라우팅, 채널 수수료는 Wholly Crypto 처리 수수료와 별도예요.

용량과 백업을 준비하세요.

노드가 수신하려면 들어오는 채널 용량이 필요해요. 연결된 지갑이라도 사용 가능한 경로나 수신 용량이 없으면 결제를 못 받을 수 있어요. 유동성 서비스가 도움이 될 수 있지만 비용과 조건은 달라요.

프로젝트 지갑 텍스트 백업은 Lightning을 백업하지 않아요. 필요한 채널 백업을 포함해 노드나 지갑의 복구 절차를 따르세요. 시드 구문만으로는 채널 자금을 안전하게 복구하지 못할 수 있어요. 청구서 추적과 암호화된 연결 인증 정보를 보존하려면 Wholly Crypto 데이터베이스와 암호화 키를 백업하세요.

LND 복구 가이드 ↗

연결부터 확인하세요.

접근 거부: 수신 권한과 인증 정보가 아직 유효한지 확인하세요.
연결 실패: HTTPS/WSS, TLS, DNS, 방화벽 접근, 지갑 온라인 상태를 확인하세요.
요청 사용 불가: 프로젝트 접근 권한, 스토어 활성화, 현재 환율, 지갑의 메인넷 상태를 확인하세요.
결제 경로 없음: Lightning 지갑의 수신 유동성을 확인하세요. API 연결이 정상이어도 경로가 있다는 뜻은 아니에요.

고객에게 Lightning을 제공하기 전에 소액 결제와 알림 흐름을 테스트하세요. 지갑 키, macaroon, NWC 비밀 정보는 지원팀에도 보내지 마세요.