Bitcoin Payment Processor

Sklep tworzy zamówienie, a jego serwer prosi procesor o fakturę z kwotą i walutą. Zapisuje powiązanie wewnętrznego numeru zamówienia z identyfikatorem faktury. Klient otrzymuje stronę płatności lub kod QR, a procesor monitoruje wpływ. Bez tego powiązania nie można wiarygodnie ustalić, które zamówienie pokrywa płatność; sam powrót w przeglądarce nie jest dowodem zapłaty. [BTCPay Server — eCommerce integration]

BTCPay Server może wyprowadzać adresy odbiorcze z publicznych danych istniejącego portfela bez jego klucza prywatnego. Różni się to od gorącego portfela przechowywanego na serwerze oraz od dostępu do środków węzła Lightning. Dostawca może trzymać środki do wypłaty. Oceniaj faktyczne posiadanie kluczy, uprawnienia i możliwość wypłaty, a nie tylko nazwę produktu lub słowo non-custodial. [BTCPay Server — General FAQ] [BitPay — Configuring settlements]

Typowa faktura BTCPay Server blokuje kurs na ograniczony czas. Wygaśnięcie nie oznacza, że późniejszy przelew nie może dotrzeć. Niedopłata, nadpłata i spóźniona płatność mają różne stany i wymagają dalszych procedur. Zachowaj pierwotną kwotę i zastosowany kurs; po zmianie ceny nowe żądanie może wymagać innej liczby satoshi. [BTCPay Server — Invoice lifecycle]

BTCPay Server rozróżnia Processing, oczekujące na ustawione potwierdzenia, oraz Settled; udane płatności Lightning przechodzą do Settled bez oczekiwania na blok. Nazw stanów innych dostawców nie można mechanicznie utożsamiać: BitPay wyraźnie ostrzega, że paid nie gwarantuje zapłaty. Sklep musi ustalić regułę wydania towaru dla konkretnego stanu i metody płatności. Ręczna zmiana stanu nie tworzy potwierdzenia sieciowego. [BTCPay Server — Invoice lifecycle] [BitPay — Invoice webhooks]

BTCPay weryfikuje webhook za pomocą HMAC-SHA256 na oryginalnych bajtach treści i wspólnym sekrecie. BitPay opisuje niepodpisane IPN: powiadomienie jest sygnałem do zapytania API o stan faktury, a nie samodzielnym wiarygodnym dowodem. Powiadomienia mogą się powtarzać. Integracja musi więc niezawodnie rozpoznawać ponownie dostarczone zdarzenie i zapobiegać drugiej wysyłce tego samego zamówienia; po awarii trzeba uzgodnić zapisane stany z procesorem. [BTCPay Server — Webhook validation example] [BitPay — Invoice webhooks]

Potwierdzenie płatności klienta nie musi nastąpić w tym samym czasie co wypłata dostawcy. BitPay pozwala ustawić walutę rozliczenia i rachunek bankowy lub adres kryptowalutowy; zmiana może wymagać zatwierdzenia. Sprawdź dostępne waluty, limity, terminy, opłaty i kontrolę środków do wypłaty. Bezpośredni wpływ do własnego portfela nie korzysta automatycznie z tego modelu wypłaty przez dostawcę. [BitPay — Configuring settlements] [BTCPay Server — General FAQ]

Zwrot wymaga kolejnej wypłaty i weryfikacji odbiorcy; nie zmienia pierwotnej transakcji bitcoinowej. Oddziel reklamację zamówienia, decyzję o zwracanej kwocie i faktyczną wysyłkę pieniędzy. Zachowuj powiązania zamówienie–faktura–płatność, kursy, opłaty i zwroty. Eksport raportu ułatwia ewidencję, ale sam nie rozwiązuje wszystkich lokalnych obowiązków księgowych ani sporu o dostawę. Nawet potwierdzony przelew sam nie rozstrzyga prawnej ostateczności transakcji: sprawdź reklamacje, ewentualny mechanizm chargeback i obowiązki wynikające ze ścieżki płatności, umowy i jurysdykcji. [BTCPay Server — Refunds] [BTCPay Server — Reporting] [BitPay — Merchant and shopper terms]

Przetestuj płatności udane, niepełne, spóźnione i wielokrotnie zgłaszane oraz odzyskiwanie po awarii. Kluczowi API nadaj tylko potrzebne uprawnienia i ogranicz go do właściwego sklepu. Nie przekazuj zbędnych danych klienta w metadanych. Uwzględnij hosting, aktualizacje, płynność i wsparcie; bezpłatne oprogramowanie nie oznacza zerowych kosztów działania. Dostępność usługi, posiadanie kluczy i poprawność integracji to odrębne warunki. [BTCPay Server — eCommerce integration] [BTCPay Server — Lightning operations]