Приймай платежі Lightning.

Підключення гаманця, не публічний вузол.

Публічна кінцева точка Bitcoin може читати блокчейн. Вона не може отримувати платежі Lightning для тебе. Lightning потребує гаманця, який створює рахунки й повідомляє про їхній розрахунок.

NWC - протокол підключення, не гарантія моделі зберігання. Обери модель гаманця, що пасує бізнесу. Wholly Crypto не зберігає коштів Lightning і не встановлює вузла.

Підключи свій вузол LND.

1. Відкрий Налаштування → Підключення блокчейнів → Підключити Lightning. Обери LND · HTTPS.
2. Введи доступну ззовні кінцеву точку HTTPS REST і обмежений macaroon у шістнадцятковому форматі. Дозволь читання/запис рахунків і info:read. Додай offchain:read , якщо хочеш бачити баланси каналів. Ніколи не використовуй admin.macaroon і не надавай дозволів на витрачання.
3. Якщо LND використовує власний TLS-сертифікат, встав його публічний PEM-сертифікат. Не вставляй приватний ключ TLS. Дозволь доступ із VPS мерчанта в брандмауері вузла.
4. Обери проєкти, яким дозволено це підключення. Перевір і збережи, потім увімкни для нових рахунків.

Вузол має бути синхронізований з основною мережею Bitcoin. Перевірка TLS залишається ввімкненою. Це підключення приймає лише публічні HTTPS-адреси; приватні, loopback і зарезервовані адреси блокуються. Тримай вузол окремо від платіжного сервера.

Дозволи macaroon LND ↗

Підключися через Nostr Wallet Connect.

1. В Alby Hub або іншому сумісному гаманці створи окреме підключення для отримання.
2. Дозволь make_invoice, lookup_invoice і get_info. get_balance необов’язковий. Не дозволяй методів оплати або виведення.
3. Обери Nostr Wallet Connect у Wholly Crypto й встав повний рядок підключення nostr+walletconnect://… . Стався до нього як до пароля.
4. Використовуй одне публічне WSS-реле в рядку підключення. Обери модель зберігання й доступ проєктів, потім перевір і збережи.

Wholly Crypto перевіряє підписані відповіді й підтримує шифрування NIP-44 v2 із сумісністю зі старим NIP-04. Гаманець має підтримувати пошук вхідних рахунків із доказом розрахунку. Не кожен обліковий запис NWC підтримує всі методи отримання.

Посібник Alby Hub ↗ · Специфікація NWC ↗

Увімкни для свого магазину.

Відкрий Проєкт → Магазини → Способи оплати → Bitcoin Lightning. Обери підключення й увімкни його. Bitcoin on-chain - окремий варіант; можна пропонувати один або обидва.

Створи невеликий рахунок вручну або через звичайний API. На сторінці оплати обери Bitcoin, а потім Bitcoin Lightning. Відскануй QR-код або відкрий запит у гаманці Lightning. Новий маршрут API для створення рахунку не потрібен.

Оплачено означає остаточний розрахунок.

Кожен запит отримує власні рахунок BOLT11 і хеш платежу. Ціни використовують фіатну валюту й спред магазину та округлюються вгору до цілих сатоші. Wholly Crypto записує надходження з точністю до мілісатоші.

Утриманого або виявленого платежу недостатньо. Гаманець має повідомити про розрахунок із чинним доказом платежу. Підтвердження блоків не потрібні. Історія рахунків, комісії за обробку, IPN і вебхуки використовують звичайний процес рахунку.

LND використовує одну підписку на розрахунки на підключення та запити відновлення. NWC використовує пошук рахунків. Очікувані запити зазвичай перевіряються приблизно кожні 10 секунд; збої, черги й ліміти провайдерів можуть затримувати оновлення. Нерозраховані запити відстежуються 24 години після терміну рахунку мерчанта.

Вимкнення або заміна даних доступу не переносить наявний запит до іншого гаманця. Залиш старі дані отримання чинними, доки очікувані запити не завершаться. Прострочені або скасовані запити не слід оплачувати.

Ця інтеграція отримує платежі. Використовуй підключений гаманець для надсилання, повернень, керування каналами або біржових переказів. Баланси Lightning - спільні баланси гаманця, не окремі гаманці проєктів. Комісії провайдера, маршрутизації й каналів відокремлені від комісії Wholly Crypto за обробку.

Підтримуй готовність місткості й резервних копій.

Вузлу потрібна вхідна місткість каналів для отримання. Підключений гаманець без придатного маршруту чи місткості отримання все одно може не прийняти платіж. Сервіс ліквідності може допомогти, але витрати й умови різняться.

Текстова резервна копія гаманця проєкту не копіює Lightning. Дотримуйся процедури відновлення вузла або гаманця, зокрема необхідних резервних копій каналів. Однієї seed-фрази може бути недостатньо для безпечного відновлення коштів каналів. Копіюй базу даних і ключ шифрування Wholly Crypto, щоб зберегти відстеження рахунків і зашифровані дані підключень.

Посібник відновлення LND ↗

Спочатку перевір підключення.

• Доступ відхилено: перевір дозволи отримання й чинність даних доступу.
• Помилка підключення: перевір HTTPS/WSS, TLS, DNS, доступ через брандмауер і чи гаманець онлайн.
• Запит недоступний: перевір доступ проєкту, активацію магазину, поточні курси й стан основної мережі гаманця.
• Немає маршруту платежу: перевір вхідну ліквідність гаманця Lightning. Справне API-підключення не доводить наявності маршруту.

Перевір невеликий платіж і його сповіщення перед пропозицією Lightning клієнтам. Ніколи не надсилай ключі гаманців, macaroons або секрети NWC до підтримки.