Софтуерът BTCPay е разделен основно на 2 части – онлайн ПОС терминал, който се използва за приемането на плащанията и админ панел, в който може да виждате история на всички минали плащания и да променяте настройките.
Ако вече имате конфигуриран виртуален магазин в BTCPay и са настроени on-chain или lightning плащанията, значи вече можете да получавате биткойн плащания – както на място, така и чрез заявки по интернет.
Ако on-chain плащанията все още не са настроени, трябва да ни изпратите Extended Public Key, за да довършим конфигурацията.
Ако lightning плащанията все още не са настроени, тогава трябва да ни изпратите АPI Key за Blink Wallet (точки 1 – 3).
Получаване на плащания
Биткойн плащания на място
Щом се логнете в админ панела на BTCPay сървъра и отворите вашия виртуален магазин (Store), в менюто отляво ще има PLUGINS -> Point of Sale и точно под него ще има предварително създаден ПОС терминал за вашия обект. Натиснете върху него и след като се отвори новата страница, отворете и самия терминал от бутона View.
Би трябвало да видите нещо такова:
Вероятно вече имате и директен път до него – от сорта на https://pos.btcpay.bg/<име-на-обект>.
Ще отваряте именно този адрес, когато някой клиент иска да плати с Bitcoin. ПОС терминалът може да се отвори от всеки смартфон или компютър, който е свързан с интернет и може да се отваря едновременно от различни устройства.
Когато някой клиент иска да плати с биткойн, трябва да отворите този адрес, да въведете желаната сума в лева и да натиснете бутона Charge.
В този момент BTCPay ще изчисли какво количество Bitcoin отговаря на тази сума и ще генерира QR код, който да се покаже на клиента за плащане.
В зависимост от активираните методи на плащане, над QR кода може да има опции Bitcoin (on-chain), Lightning или друго, като просто трябва да изберете метода, който клиентът желае да използва. Обикновено за по-малки суми (напр. под 50 лева) активираме само lightning плащанията, като on-chain плащанията стават активни ако въведената сума е по-голяма. Но лимитът от 50 лева за on-chain плащанията подлежи на конфигурация и може да се смени по всяко време от настройките.
Всяко натискане на Charge ще създава нова BTCPay фактура (Invoice), която може да се види в админ панела в секцията PAYMENTS → Invoices, като първоначално ще е със статус New и ще е валидна за 15-минути. Плащането трябва да се извърши през този период, защото след изтичането му инвойсът ще се маркира като Expired, т.е. изтекъл и плащането след това няма да бъде отчетено правилно в системата. Това се случва, защото в рамките на тези 15 минути цената на биткойн може да се промени и предварително изчислената сума вече да не отговаря на сумата, която е въведена в лева.
Щом клиентът сканира QR кода с негов портфейл и направи плащането, ПОС терминалът ще го отбележи като завършено и ще се визуализира екран като този:
Ако плащането е направено чрез Lightning Network, инвойсът веднага ще се маркира като Settled в админ панела и средствата ще са станали налични в Lightning портфейла ви. Плащането в този случай е напълно финализирано и няма начин да бъде върнато.
Ако плащането е направено в основната мрежата на биткойн (on-chain), то обработката и финализиране на трансакцията отнема около 10 минути. Затова при on-chain плащанията щом клиентът сканира кода с неговия мобилен портфейл, инвойсът първо се маркира като Processing и едва след като трансакцията бъде обработена и финализирана, инвойсът ще бъде отбелязан като Settled и наистина ще получите биткойните в портфейла си.
За да разберете дали плащането е финализирано или все още се обработва, натиснете бутона View receipt.
При финализирано плащане ще видите разписка като тази:
Тя показва, че плащането е изцяло завършено и не може да бъде върнато.
Ако on-chain плащането все още се обработва, тогава вместо разписка, ще видите това:
Това показва, че клиентът е наредил on-chain плащането от неговия портфейл, но то все още не е записано в биткойн мрежата.
Затова ако приемате големи плащания и клиентът е платил on-chain, задължително изчакайте статус Settled и финализиране на плащането, преди да предоставите продукта на клиента или преди да го пуснете да си отиде. Получените биткойн средства ще бъдат налични в портфейла ви едва след като трансакцията бъде обработена и инвойсът бъде отбелязан като Settled.
Освен директно в портфейла ви, получените плащания в основната мрежа могат да бъдат видяни и чрез админ панела в WALLETS → Wallet.
Създаване на пряк път до ПОС терминала
Ако ще приемате биткойн плащания във физически обект, можете да отворите ПОС терминала от устройството, с което ще се приемат биткойн плащания в обекта и да го добавите като отделна икона към основния ви екран в устройството. Ако използвате например iPhone, това може да стане като отворите ПОС терминала с браузъра Safari, натиснете бутона за споделяне и след това натиснете бутона Add to Home Screen. Това ще създаде пряк път към ПОС терминала, като така ще можете да реагирате по-бързо с отваряне на терминала, ако някой клиент поиска да плати с биткойн.
Всички браузъри и телефони имат подобна опция, така че просто отворете ПОС терминала с браузъра на телефона ви, натиснете върху допълнителното меню (може да е ⋮) и там потърсете Add to Home Screen или Добави към началния екран.
Заявки за плащане по интернет
Освен плащания на място, можете да правите и заявки за плащане по интернет от секцията PAYMENTS → Requests. Подобна заявка за плащане изглежда така. Щом създадете някой Request, можете да го отворите от VIEW, да вземете URL-a му и да го пратите на клиент по имейл, Viber и т.н. Щом клиентът натисне PAY бутона в Request-а, това ще му генерира QR код и Invoice за плащане. И щом го плати, това ще бъде отразено в самия Request, а инвойсът ще бъде отбелязан като Settled или като Processing (ако е необходимо одобрение на трансакцията при on-chain плащане).
Допълнителна информация
Препоръчително е първо лично да направите едно плащане за някаква малка сума в биткойн чрез ПОС терминала, за да се уверите, че биткойните ще пристигнат в портфейл, който е конфигуриран чрез вашия Public Extended Key. Ако приемате и Lightning плащанията, направете тестово плащане и там.
Това е основното. Ако имате други въпроси – пишете в коментарите. 🙂