Платіжний процесор ZGo: приймання Zcash без кастодіального зберігання
ZGo — це некастодіальний платіжний процесор для Zcash. Клієнт платить у ZEC зі свого власного гаманця, ZGo відстежує транзакцію в блокчейні Zcash, а кошти надходять безпосередньо в гаманець продавця через shielded-переказ. ZGo ніколи не утримує гроші між цими етапами.
У цьому посібнику пояснюється, як працює платіжний потік, як налаштувати обліковий запис і як інтегрувати ZGo з Xero та WooCommerce. Також тут розглядаються дві помилки, які спричиняють більшість проблем під час першого налаштування.
На цій сторінці
- Навіщо використовувати ZGo
- Як працює ZGo
- Налаштування облікового запису
- ZGo з Xero
- ZGo з WooCommerce
- Функції
- Поширені помилки
- Висновок
- Ресурси
Навіщо використовувати ZGo
Більшість платіжних процесорів для криптовалют є кастодіальними. Кошти спочатку надходять на рахунок процесора і лише пізніше пересилаються продавцю, а це означає, що третя сторона тимчасово контролює гроші й може їх заморозити, затримати або звітувати про них.
ZGo використовує протилежний підхід. Платежі переміщуються з гаманця клієнта безпосередньо до гаманця продавця через shielded-транзакцію Zcash. Процесор лише генерує рахунок і відстежує блокчейн для підтвердження. Тут немає проміжного балансу, немає процесу виведення коштів і немає третьої сторони, яка може затримати розрахунок.
Для продавця це означає три практичні речі: повний контроль над вхідними ZEC, конфіденційність shielded-транзакцій за замовчуванням і відсутність залежності від централізованого провайдера, який має залишатися онлайн і платоспроможним.
Як працює ZGo
Платіжний потік однаковий незалежно від того, чи використовується ZGo окремо, через Xero або через WooCommerce:
- Продавець генерує запит на оплату в ZGo, який відображається як QR-код із сумою, ID рахунку та адресою отримання Zcash.
- Клієнт сканує QR за допомогою гаманця Zcash (у плагіні WordPress підтримуються типи адрес Orchard, Sapling і Transparent) і підтверджує платіж.
- Транзакція транслюється в мережу Zcash як shielded-переказ з гаманця клієнта до гаманця продавця.
- ZGo відстежує транзакцію в блокчейні Zcash.
- Після п’яти підтверджень ZGo позначає платіж як остаточний і сповіщає будь-яку підключену інтеграцію (Xero, WooCommerce або webhook).
Поріг у п’ять підтверджень — це ключове число. Будь-що раніше — це платіж у процесі, а не отриманий платіж. Виконання замовлення, оновлення запасів і будь-які незворотні дії з боку продавця мають чекати до кроку 5.
ZGo працює в будь-якому сучасному браузері на комп’ютері або мобільному пристрої, без встановлення з будь-якого боку. Клієнту потрібен гаманець Zcash; продавцю потрібні гаманець Zcash і обліковий запис ZGo.
Налаштування облікового запису
Щоб створити обліковий запис ZGo, потрібен гаманець Zcash із невеликою кількістю ZEC. Невеликий баланс ZEC покриває комісію on-chain за транзакцію ініціалізації облікового запису. Для цього підійде будь-який основний гаманець Zcash; актуальні варіанти дивіться в Гаманці ZecHub.
Базове налаштування:
- Відкрийте zgo.cash у браузері.
- Створіть обліковий запис, використовуючи гаманець Zcash, який перебуває під контролем продавця. Цей гаманець має зберігати ключі. Депозитна адреса біржі не підійде (див. Поширені помилки).
- Підтвердьте гаманець, надіславши невелику транзакцію ініціалізації.
- Налаштуйте адресу отримання. Усі платежі, оброблені через цей обліковий запис, надходитимуть у цей гаманець.
Щойно обліковий запис стане активним, той самий продавець зможе використовувати ZGo для разових платежів (один QR-код на поп-ап заході) або підключити його до постійної конфігурації через Xero чи WooCommerce.
ZGo з Xero
Xero — це хмарна бухгалтерська платформа, яку використовують багато малих і середніх компаній. Інтеграція ZGo–Xero дає змогу продавцю виставити рахунок у Xero, дозволити клієнту оплатити його в ZEC і автоматично позначити цей рахунок у Xero як оплачений після підтвердження транзакції.
Як це працює:
- Продавець створює рахунок у Xero як зазвичай.
- ZGo додає до рахунку опцію оплати в Zcash.
- Клієнт платить у ZEC через свій гаманець.
- ZGo відстежує транзакцію в блокчейні Zcash.
- Після п’яти підтверджень ZGo повідомляє про платіж назад у Xero, і Xero позначає рахунок як оплачений.
ZEC надходять у гаманець продавця, а не на будь-який рахунок під контролем ZGo або Xero. Обліковий запис у Xero автоматично залишається синхронізованим із on-chain-розрахунком.
Для першого налаштування скористайтеся окремою покроковою інструкцією: Налаштування інтеграції Xero.
ZGo з WooCommerce
Для онлайн-магазинів, що працюють на WooCommerce і WordPress, ZGo надає окремий плагін. Плагін додає Zcash як спосіб оплати під час оформлення замовлення та автоматично обробляє стан замовлення після підтвердження платежу.
Повний потік усередині магазину WooCommerce:
- Клієнт переходить до оформлення замовлення й обирає Zcash як спосіб оплати.
- Плагін генерує запит на оплату та показує QR-код на сторінці оформлення замовлення.
- Клієнт платить зі свого гаманця.
- Транзакція транслюється в мережу Zcash, і ZGo починає її відстежувати.
- Після п’яти підтверджень ZGo повідомляє плагіну, що платіж є остаточним.
- Плагін позначає замовлення WooCommerce як оплачене й оновлює базу даних замовлень.
Замовлення вважається оплаченим лише після завершення кроку 6. Попередні стани (трансляція, перші підтвердження) можна показувати клієнту як "платіж отримано, очікується підтвердження", але облік запасів, виконання замовлення та будь-яка подальша автоматизація мають чекати на фінальний стан.
Плагін також встановлює адміністративну панель у WordPress, де продавець може відстежувати замовлення та вхідні платежі в ZEC поряд зі звичайним переглядом замовлень WooCommerce. Плагін підтримує всі актуальні типи адрес Zcash: Orchard, Sapling і Transparent. Клієнти, які платять із будь-якого сумісного гаманця, можуть завершити транзакцію.
Функції
Некастодіальність. Платежі переміщуються безпосередньо з гаманця клієнта до гаманця продавця через shielded-транзакції. ZGo ніколи не утримує кошти між цими етапами, а продавець зберігає повний контроль упродовж усього процесу.
Гнучке розгортання. ZGo можна використовувати для одного дня на поп-ап маркеті, для постійної точки продажу або як бекенд для онлайн-магазину через інтеграції Xero чи WooCommerce.
На базі браузера. Жодного встановлення ні з боку клієнта, ні з боку продавця. ZGo працює в будь-якому сучасному браузері на комп’ютері або мобільному пристрої.
Сумісність із гаманцями. Основні гаманці Zcash, включно з тими, що підтримують типи адрес Orchard, Sapling і Transparent, можуть оплатити рахунок ZGo без додаткового налаштування з боку клієнта.
Інтеграції. Прямі інтеграції з Xero (бухгалтерія) і WooCommerce (електронна комерція) покривають два найпоширеніші сценарії роботи продавців одразу з коробки.
Поширені помилки
Вважати замовлення оплаченим до п’яти підтверджень. Трансльована транзакція — це не те саме, що підтверджений платіж. Транзакція все ще може не отримати підтвердження або бути заміненою. Лише після п’яти підтверджень ZGo повідомляє про платіж як про остаточний, і лише тоді замовлення слід позначати як оплачене в усіх подальших системах. Якщо продавець налаштує запуск обліку запасів або виконання замовлення на подію трансляції, шахрайські або невдалі платежі спричинять реальні збитки.
Вказувати в ZGo депозитну адресу біржі. Вона виглядає як адреса Zcash, але депозитні адреси біржі контролюються біржею, а не продавцем. Біржа зберігає ключі, а це означає, що біржа контролює кошти, що нівелює сенс використання некастодіального процесора. Адреса гаманця, налаштована в ZGo, має належати гаманцю, seed phrase якого продавець контролює безпосередньо.
Сприймати ZGo як гаманець. ZGo — це платіжний процесор, а не гаманець. Він не зберігає ключі, не утримує баланси й не дозволяє продавцю витрачати кошти. Щоб отримувати гроші, які маршрутизує ZGo, потрібен окремий гаманець Zcash під контролем продавця.
Висновок
ZGo дає продавцям змогу приймати платежі в Zcash без втрати контролю над коштами, без залежності від посередника і без розкриття деталей транзакцій у публічному ланцюзі. Дві інтеграції (Xero і WooCommerce) покривають найпоширеніші сценарії роботи продавців; для всього іншого ZGo можна використовувати окремо з будь-якого браузера.
Для налаштування шлях короткий: отримайте гаманець Zcash, створіть обліковий запис на zgo.cash і або почніть безпосередньо генерувати запити на оплату, або встановіть відповідну інтеграцію.
Ресурси
