Nhận thanh toán Lightning.

Kết nối ví, không phải node công khai.

Endpoint Bitcoin công khai có thể đọc blockchain. Nó không thể nhận thanh toán Lightning cho bạn. Lightning cần ví tạo hóa đơn và báo khi chúng được quyết toán.

NWC là giao thức kết nối, không phải bảo đảm về lưu ký. Chọn mô hình ví phù hợp với doanh nghiệp. Wholly Crypto không giữ tiền Lightning hay cài node.

Kết nối node LND của bạn.

1. Mở Cài đặt → Kết nối chuỗi → Kết nối Lightning. Chọn LND · HTTPS.
2. Nhập endpoint HTTPS REST truy cập được từ bên ngoài và macaroon hạn chế ở dạng thập lục phân. Cho phép đọc/ghi hóa đơn và info:read. Thêm offchain:read nếu muốn hiển thị số dư kênh. Không bao giờ dùng admin.macaroon hay cấp quyền chi tiêu.
3. Nếu LND dùng chứng chỉ TLS riêng, dán chứng chỉ PEM công khai. Không dán khóa riêng TLS. Cho phép VPS nhà bán hàng truy cập tại tường lửa node.
4. Chọn dự án được dùng kết nối. Kiểm tra và lưu, rồi bật cho hóa đơn mới.

Node phải đồng bộ với mainnet Bitcoin. Xác minh TLS vẫn bật. Kết nối này chỉ chấp nhận địa chỉ HTTPS công khai; địa chỉ riêng, loopback và dành riêng bị chặn. Giữ node tách biệt với máy chủ thanh toán.

Quyền macaroon LND ↗

Kết nối qua Nostr Wallet Connect.

1. Trong Alby Hub hoặc ví tương thích khác, tạo kết nối nhận chuyên dụng.
2. Cho phép make_invoice, lookup_invoice và get_info. get_balance là tùy chọn. Không cho phép phương thức thanh toán hay rút tiền.
3. Chọn Nostr Wallet Connect trong Wholly Crypto và dán đầy đủ nostr+walletconnect://… chuỗi kết nối. Hãy bảo vệ nó như mật khẩu.
4. Dùng một relay WSS công khai trong chuỗi kết nối. Chọn mô hình lưu ký và quyền truy cập dự án, rồi kiểm tra và lưu.

Wholly Crypto xác minh phản hồi đã ký và hỗ trợ mã hóa NIP-44 v2, đồng thời tương thích với NIP-04 cũ. Ví phải hỗ trợ tra cứu hóa đơn nhận tiền kèm bằng chứng quyết toán. Không phải tài khoản NWC nào cũng hỗ trợ mọi phương thức nhận tiền.

Hướng dẫn Alby Hub ↗ · Đặc tả NWC ↗

Bật cho cửa hàng của bạn.

Mở Dự án → Cửa hàng → Phương thức thanh toán → Bitcoin Lightning. Chọn kết nối và bật lên. Bitcoin trên chuỗi là lựa chọn riêng; bạn có thể cung cấp một trong hai hoặc cả hai.

Tạo một hóa đơn nhỏ theo cách thủ công hoặc qua API thông thường. Trên trang thanh toán, chọn Bitcoin rồi chọn Bitcoin Lightning. Quét mã QR hoặc mở yêu cầu trong ví Lightning. Không cần tuyến API mới để tạo hóa đơn.

Đã thanh toán nghĩa là đã quyết toán.

Mỗi yêu cầu có hóa đơn BOLT11 và mã băm thanh toán riêng. Giá dùng tiền pháp định và mức chênh lệch của cửa hàng, làm tròn lên satoshi nguyên. Wholly Crypto ghi nhận khoản nhận với độ chính xác đến millisatoshi.

Khoản thanh toán đang được giữ hoặc mới phát hiện là chưa đủ. Ví phải báo đã quyết toán kèm bằng chứng thanh toán hợp lệ. Không cần xác nhận khối. Lịch sử hóa đơn, phí xử lý, IPN và webhook theo quy trình hóa đơn thông thường.

LND dùng một đăng ký theo dõi quyết toán cho mỗi kết nối cùng các lượt tra cứu khôi phục. NWC dùng tra cứu hóa đơn. Yêu cầu đang chờ thường được tra cứu khoảng mỗi 10 giây; sự cố, hàng đợi và giới hạn của nhà cung cấp có thể làm chậm cập nhật. Yêu cầu chưa quyết toán tiếp tục được theo dõi trong 24 giờ sau hạn hóa đơn của nhà bán hàng.

Vô hiệu hóa hoặc thay thông tin xác thực không chuyển yêu cầu hiện có sang ví khác. Giữ thông tin xác thực nhận tiền cũ hoạt động đến khi các yêu cầu đang chờ hoàn tất. Không thanh toán yêu cầu đã hết hạn hoặc bị hủy.

Tích hợp này dùng để nhận thanh toán. Dùng ví đã kết nối để gửi tiền, hoàn tiền, quản lý kênh hoặc chuyển tiền lên sàn. Số dư Lightning là số dư ví dùng chung, không phải ví dự án riêng biệt. Phí nhà cung cấp, định tuyến và kênh tách biệt với phí xử lý của Wholly Crypto.

Chuẩn bị sẵn khả năng nhận tiền và bản sao lưu.

Nút của bạn cần dung lượng kênh chiều vào để nhận tiền. Ví đã kết nối nhưng không có tuyến khả dụng hoặc khả năng nhận vẫn có thể không nhận được thanh toán. Dịch vụ thanh khoản có thể giúp ích, nhưng chi phí và điều kiện khác nhau.

Bản sao lưu văn bản của ví dự án không sao lưu Lightning. Làm theo quy trình khôi phục của nút hoặc ví, bao gồm các bản sao lưu kênh bắt buộc. Chỉ cụm từ khôi phục có thể không đủ để khôi phục tiền trong kênh an toàn. Sao lưu cơ sở dữ liệu và khóa mã hóa của Wholly Crypto để giữ thông tin theo dõi hóa đơn và thông tin xác thực kết nối đã mã hóa.

Hướng dẫn khôi phục LND ↗

Kiểm tra kết nối trước.

• Truy cập bị từ chối: kiểm tra quyền nhận tiền và xem thông tin xác thực còn hợp lệ không.
• Kết nối thất bại: kiểm tra HTTPS/WSS, TLS, DNS, quyền truy cập qua tường lửa và xem ví có trực tuyến không.
• Yêu cầu không khả dụng: kiểm tra quyền truy cập dự án, việc kích hoạt cửa hàng, tỷ giá hiện tại và trạng thái mainnet của ví.
• Không thể định tuyến thanh toán: kiểm tra thanh khoản chiều vào trong ví Lightning. Kết nối API hoạt động tốt không chứng minh rằng có tuyến thanh toán.

Thử một khoản thanh toán nhỏ cùng luồng thông báo trước khi cung cấp Lightning cho khách hàng. Không bao giờ gửi khóa ví, macaroon hoặc bí mật NWC cho bộ phận hỗ trợ.