Платёжный процессор ZGo: приём Zcash без кастодиального хранения
ZGo — это некастодиальный платёжный процессор для Zcash. Клиент платит в ZEC из собственного кошелька, ZGo отслеживает транзакцию в блокчейне Zcash, а средства поступают напрямую в кошелёк продавца через защищённый перевод. ZGo никогда не удерживает деньги у себя между этими этапами.
В этом руководстве объясняется, как работает платёжный процесс, как настроить учётную запись и как интегрировать ZGo с Xero и WooCommerce. Также здесь рассматриваются две ошибки, из-за которых возникает большинство проблем при первой настройке.
На этой странице
- Зачем использовать ZGo
- Как работает ZGo
- Настройка учётной записи
- ZGo с Xero
- ZGo с WooCommerce
- Возможности
- Распространённые ошибки
- Заключение
- Ресурсы
Зачем использовать ZGo
Большинство платёжных процессоров для криптовалют являются кастодиальными. Сначала средства поступают на счёт процессора, а затем позже пересылаются продавцу, а это означает, что третья сторона временно контролирует деньги и может заморозить их, задержать перевод или отчитываться о них.
ZGo использует противоположный подход. Платежи перемещаются из кошелька клиента напрямую в кошелёк продавца через защищённую транзакцию Zcash. Процессор лишь создаёт инвойс и отслеживает подтверждение в блокчейне. Здесь нет промежуточного баланса, нет процесса вывода и нет третьей стороны, которая может задержать расчёт.
Для продавца это означает три практических преимущества: полный контроль над входящими ZEC, конфиденциальность защищённых транзакций по умолчанию и отсутствие зависимости от того, остаётся ли централизованный провайдер онлайн и платёжеспособным.
Как работает ZGo
Платёжный процесс одинаков независимо от того, используется ли ZGo отдельно, через Xero или через WooCommerce:
- Продавец создаёт платёжный запрос в ZGo, который отображается как QR-код с суммой, идентификатором инвойса и адресом получения Zcash.
- Клиент сканирует QR-код с помощью кошелька Zcash (в плагине WordPress поддерживаются все типы адресов: Orchard, Sapling и Transparent) и подтверждает платёж.
- Транзакция отправляется в сеть Zcash как защищённый перевод из кошелька клиента в кошелёк продавца.
- ZGo отслеживает транзакцию в блокчейне Zcash.
- После пяти подтверждений ZGo помечает платёж как окончательный и уведомляет об этом любую подключённую интеграцию (Xero, WooCommerce или webhook).
Порог в пять подтверждений — это ключевое число. Всё, что происходит раньше, — это платёж в процессе, а не полученный платёж. Выполнение заказа, обновление остатков и любые необратимые действия со стороны продавца должны ждать шага 5.
ZGo работает в любом современном браузере на компьютере или мобильном устройстве, без установки с обеих сторон. Клиенту нужен кошелёк Zcash; продавцу нужен кошелёк Zcash и учётная запись ZGo.
Настройка учётной записи
Для создания учётной записи ZGo требуется кошелёк Zcash с небольшим количеством ZEC. Небольшой баланс ZEC покрывает комиссию в сети за транзакцию инициализации учётной записи. Для этого подойдёт любой крупный кошелёк 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 автоматически остаётся синхронизированной с расчётом в блокчейне.
Для первой настройки следуйте специальному пошаговому руководству: Настройка интеграции с Xero.
ZGo с WooCommerce
Для интернет-магазинов на базе WooCommerce и WordPress у ZGo есть отдельный плагин. Этот плагин добавляет Zcash как способ оплаты при оформлении заказа и автоматически обрабатывает состояние заказа после подтверждения платежа.
Полный процесс внутри магазина WooCommerce:
- Клиент переходит к оформлению заказа и выбирает Zcash в качестве способа оплаты.
- Плагин создаёт платёжный запрос и показывает QR-код на странице оформления заказа.
- Клиент платит из своего кошелька.
- Транзакция отправляется в сеть Zcash, и ZGo начинает её отслеживать.
- После пяти подтверждений ZGo сообщает плагину, что платёж окончательный.
- Плагин помечает заказ WooCommerce как оплаченный и обновляет базу данных заказов.
Заказ считается оплаченным только после завершения шага 6. Более ранние состояния (отправка транзакции, первые подтверждения) можно показывать клиенту как «платёж получен, ожидается подтверждение», но учёт остатков, исполнение заказа и любая последующая автоматизация должны ждать окончательного состояния.
Плагин также устанавливает административную панель внутри WordPress, где продавец может отслеживать заказы и входящие платежи в ZEC наряду с обычным представлением заказов WooCommerce. Плагин поддерживает все актуальные типы адресов Zcash: Orchard, Sapling и Transparent. Клиенты, оплачивающие из любого совместимого кошелька, могут завершить транзакцию.
Возможности
Некастодиальность. Платежи перемещаются напрямую из кошелька клиента в кошелёк продавца через защищённые транзакции. ZGo никогда не удерживает средства у себя между этапами, а продавец сохраняет полный контроль на всём протяжении процесса.
Гибкость развёртывания. ZGo можно использовать на один день на выездном рынке, для постоянной точки продаж или как бэкенд интернет-магазина через интеграции с Xero или WooCommerce.
Работа через браузер. Не требует установки ни со стороны клиента, ни со стороны продавца. ZGo работает в любом современном браузере на компьютере или мобильном устройстве.
Совместимость с кошельками. Популярные кошельки Zcash, включая поддерживающие типы адресов Orchard, Sapling и Transparent, могут оплатить инвойс ZGo без дополнительной настройки со стороны клиента.
Интеграции. Прямые интеграции с Xero (бухгалтерия) и WooCommerce (электронная коммерция) из коробки покрывают два самых распространённых сценария работы продавцов.
Распространённые ошибки
Считать заказ оплаченным до пяти подтверждений. Отправленная в сеть транзакция — не то же самое, что подтверждённый платёж. Транзакция всё ещё может не получить подтверждение или быть заменена. Только после пяти подтверждений ZGo сообщает о платеже как об окончательном, и только тогда заказ должен помечаться как оплаченный в последующих системах. Если продавец настроит запуск учёта остатков или исполнения заказа по событию отправки транзакции, мошеннические или неудавшиеся платежи приведут к реальным потерям.
Указывать в ZGo депозитный адрес биржи. Он выглядит как адрес Zcash, но депозитные адреса бирж контролируются биржей, а не продавцом. Биржа владеет ключами, а значит, биржа владеет и средствами, что лишает смысла использование некастодиального процессора. Адрес кошелька, настроенный в ZGo, должен принадлежать кошельку, seed-фразу которого продавец контролирует напрямую.
Считать ZGo кошельком. ZGo — это платёжный процессор, а не кошелёк. Он не хранит ключи, не удерживает балансы и не позволяет продавцу тратить средства. Для получения денег, которые направляет ZGo, требуется отдельный кошелёк Zcash под контролем продавца.
Заключение
ZGo даёт продавцам возможность принимать платежи в Zcash без отказа от контроля над средствами, без зависимости от посредника и без раскрытия деталей транзакций в публичной цепочке. Две интеграции (Xero и WooCommerce) покрывают наиболее распространённые сценарии работы продавцов; во всех остальных случаях ZGo можно использовать отдельно из любого браузера.
Путь настройки короткий: получите кошелёк Zcash, создайте учётную запись на zgo.cash и либо начните напрямую создавать платёжные запросы, либо установите нужную интеграцию.
Ресурсы
