Приймання платежів через PayHot

Покроковий гайд: як підключити PayHot до CreateYourVPN, щоб клієнти поповнювали баланс на будь-яку суму карткою, через СБП або криптовалютою. Заявка, API-ключ, вебхук, способи оплати й автопоповнення.

PayHot приймає оплату банківською карткою, через СБП і криптовалютою. Через нього клієнти поповнюють баланс у кабінеті на вашій вітрині, а тарифи купують з балансу: видавати доступ руками не треба.

У PayHot клієнт сам вводить суму, і разово, і в автопоповненні. Заводити суми поповнення не обов'язково. Якщо ви їх заведете, PayHot продає і їх, а клієнт бачить їх кнопками над полем суми. У lava.top суми фіксовані: клієнт обирає лише з ваших.

Гроші йдуть на баланс вашого проєкту в PayHot. CreateYourVPN не є посередником у платежах і комісії з ваших продажів не бере.

Приймання платежів доступне на платному тарифі Max: на ньому вітрина починає продавати, а баланс клієнтів вмикається сам. Про тарифи платформи розказано в уроці про білінг.

Що знадобиться

тариф Max у CreateYourVPN;
схвалена заявка в PayHot: схвалення триває кілька днів, тому подайте її заздалегідь;
близько 15 хвилин на налаштування після схвалення.

Крок 1. Надішліть заявку

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

Крок 2. Випустіть API-ключ

Щойно заявку схвалять, ви зможете увійти в особистий кабінет PayHot. Випустіть у ньому API-ключ для CreateYourVPN. Якщо PayHot запропонує вибрати строк дії та права ключа, оберіть строк «Unlimited» і права «Платежі» та «Перегляд»: коли строк дії ключа мине, продажі зупиняться.

Інших прав ключу не надавайте, особливо на виплати. Ключем із правом виплат можна вивести гроші з балансу вашого проєкту в PayHot на чужу картку. CreateYourVPN виплати не потрібні: ми лише створюємо платежі й перевіряємо їхній статус.

Крок 3. Підключіть PayHot у CreateYourVPN

У CreateYourVPN відкрийте розділ «Монетизація», натисніть «Підключити» на картці PayHot, вставте ключ у поле «API-ключ PayHot» і натисніть «Підключити». Ключ перевіриться сам: якщо все гаразд, з'явиться рядок «PayHot прийняв ключ».

На картці з'явиться «Webhook URL». Скопіюйте його кнопкою «Копіювати», вставте в кабінеті PayHot у поле Webhook URL · Production і збережіть.

Після збереження PayHot один раз покаже секрет підпису. Скопіюйте його, вставте в поле «Секрет підпису вебхука (необов'язково)» під адресою на картці PayHot і натисніть «Зберегти».

Через вебхук PayHot одразу повідомляє нам про оплати й повернення, а на картці з'являється дата останнього вебхука. Без вебхука й секрету підпису оплати теж підтверджуються: ми самі перевіряємо їх у PayHot, лише пізніше. Але про повернення без вебхука ми не дізнаємося.

Прапорець «Приймати платежі» на картці залиште ввімкненим. Пізніше ключ можна перевірити ще раз: відкрийте картку кнопкою «Налаштувати» і натисніть «Перевірити ключ».

Крок 4. Увімкніть способи оплати

Переконайтеся, що в кабінеті PayHot увімкнено потрібні види оплати: банківські картки, СБП, криптовалюту. Клієнтам доступні лише способи, увімкнені в PayHot.

На картці PayHot у CreateYourVPN, у блоці «Способи оплати», залиште позначеними ті самі способи: «Картки РФ (₽)», «Іноземні картки (€)», «СБП» і «Криптовалюта». За замовчуванням позначено всі. Зніміть позначку зі способу, якого немає в PayHot, і натисніть «Зберегти»: інакше клієнт побачить спосіб, але оплатити ним не зможе.

Крок 5. Поповнення балансу

Тарифи налаштовувати не потрібно: клієнт купує їх з балансу, а PayHot поповнює баланс. Виняток: тариф із ціною в іншій валюті, раніше прив'язаний до PayHot, клієнт оплачує через PayHot напряму.

Разове поповнення

У кабінеті на вітрині клієнт натискає «Поповнити» і вводить суму в поле «Сума». Над полем кнопками стоять ваші суми з блоку «Поповнення балансу» на сторінці «Тарифи», якщо ви їх завели. Сума може бути будь-якою, оферта lava.top для PayHot не потрібна: у вікні суми кабінет напише, якими способами PayHot її продає.

Якщо на тариф не вистачає грошей, клієнт натискає «Поповнити й купити», і першою сумою ми пропонуємо рівно нестачу, але не менше за мінімальний платіж: доплатити й купити тариф можна однією оплатою.

Спосіб у валюті кабінету клієнтів клієнт оплачує рівно введеною сумою. Інші валюти, наприклад іноземну картку в євро або криптовалюту при кабінеті в рублях, ми перераховуємо за курсом вашої каси PayHot; якщо в каси курсу немає, картку й СБП рахуємо за курсом Банку Росії. Суму до оплати клієнт бачить на кнопці «Оплатити», а на баланс надходить введена сума. Криптовалюта йде в USDT у мережі TRON (TRC-20). При кабінеті в доларах іноземної картки немає: PayHot приймає картку РФ і СБП у рублях та криптовалюту.

У PayHot є мінімальний платіж: 100 ₽ карткою РФ або через СБП, 5 € іноземною карткою і 10 USDT криптовалютою. Якщо клієнт введе менше, під полем з'явиться підказка, наприклад «Мінімальна сума 100 ₽.». Спосіб, для якого сума менша за його мінімум, клієнт не побачить: криптовалюта з'явиться, лише коли сума досягне 10 USDT за курсом каси.

Автопоповнення

На вкладці «Автоматично» клієнт вводить суму і «Раз на скільки днів» її списувати, від 1 до 365. Якщо у вас є й автопоповнення lava.top, це рядок «Своя сума і частота». Першу оплату клієнт робить одразу, далі ми списуємо ту саму суму з прив'язаної картки або рахунку СБП раз на вибрану кількість днів, і кожне списання поповнює баланс.

Автопоповнення працює разом з автопродовженням тарифу з балансу: під час підключення автопродовження ввімкнеться саме, а якщо тарифу в клієнта ще немає, перше списання його купить. Автопоповнення в клієнта одне: через PayHot або через підписку lava.top.

Щоб автопоповнення через PayHot працювало:

у вас має бути тариф-підписка зі строком і ціною у валюті кабінету клієнтів: без нього вкладки «Автоматично» в клієнта немає;
валюта кабінету клієнтів має бути в рублях, а в підключенні мають бути позначені «Картки РФ (₽)» або «СБП»: списувати можна лише ними;
ключ має бути бойовим, у тестовому режимі автопоповнення немає;
у касі PayHot мають бути підключені автосписання. PayHot підключає їх на запит: напишіть своєму менеджеру PayHot. Якщо запитають, як клієнт відв'язує картку, відповідь така: у кабінеті на вітрині в автопоповнення є кнопка «Вимкнути», вона відв'язує картку або рахунок СБП;
комісія каси PayHot має бути на вас, а не на клієнтові, інакше прив'язка не створиться.

Якщо каса відмовить у прив'язці, клієнт побачить «Автопоповнення зараз не можна ввімкнути. Поповнити баланс можна і без нього.», а цей спосіб зникне з автопоповнення на добу. Коли налаштуєте касу, збережіть підключення PayHot у розділі «Монетизація», і спосіб повернеться одразу.

Клієнт вимикає автопоповнення сам, кнопкою «Вимкнути» в кабінеті на вітрині. Якщо він вимкне автопродовження тарифу, автопоповнення вимкнеться разом із ним. Вимкнути автопоповнення в усіх клієнтів разом можна на картці PayHot кнопкою «Закрити підписки»: прив'язані картки й рахунки СБП відв'яжуться, гроші на балансах збережуться.

Крок 6. Перевірте оплату

З клієнтського акаунта на своїй вітрині поповніть баланс на мінімальну суму, при кабінеті в рублях це 100 ₽. Гроші мають з'явитися на балансі, а поповнення в розділі «Монетизація», у блоці «Журнал платежів», отримати статус «Оброблено». З вебхуком це зазвичай триває до хвилини, без вебхука довше.

Перевірити без справжніх грошей можна з тестовим ключем PayHot (він починається з phk_test_v2_): вставте його в картку замість бойового. Оплата пройде на тестовій сторінці PayHot і з'явиться в журналі з позначкою «тест», а баланс не зміниться. З тестовим ключем залишаються лише способи у валюті кабінету клієнтів, без криптовалюти й автопоповнення. Поки стоїть тестовий ключ, у тестовому режимі платять усі ваші клієнти, і попередження вони не бачать: перевіряйте до початку продажів і одразу поверніть бойовий ключ.

Про гроші

Гроші за оплати надходять на баланс вашого проєкту в PayHot. Комісію бере PayHot на своїх умовах, CreateYourVPN своєї не додає.
Повернення робляться в PayHot: у кабінеті PayHot або через його підтримку. Якщо налаштовано вебхук і секрет підпису, у журналі в поповнення з'явиться позначка «Повернення поповнення»; без них стежте за поверненнями в PayHot самі. Баланс клієнта після повернення сам не зменшиться: спишіть ту саму суму коригуванням у картці клієнта.

Якщо ключ витік

Перевипустіть API-ключ у PayHot: старий ключ одразу перестане працювати. Потім вставте новий ключ у картку PayHot у розділі «Монетизація» і збережіть.

Приймання платежів через PayHot

On this page