Пользовательское приложение Shopify

Модель интеграции

Интеграция Shopify использует процесс приложения Shopify V2 Dev Dashboard. merchant предоставляет одноразовый токен Shopify Partner CLI, чтобы MakeCrypto мог создать прикрепленное приложение MakePay на панели инструментов Shopify Dev с помощью Shopify CLI. MakeCrypto автоматически считывает сгенерированный идентификатор клиента. Shopify по-прежнему отображает секрет клиента только на панели разработки, поэтому merchant копирует этот секрет в MakeCrypto перед развертыванием.

После развертывания и установки приложения Shopify запускает MakeCrypto с подписанным токеном сеанса. MakeCrypto проверяет этот токен с секретом клиента и обменивает его на автономный токен администратора API. Этот токен зашифрован в хранении и используется для того же потока заказов MakePay: синхронизация заказов, размещенные ссылки для оплаты, примечания/теги, webhooks и дополнительная автоматизация маркировки платежей.

Устаревшая конфигурация с токеном доступа администратора API больше не поддерживается для новых подключений Shopify. Существующие магазины, подключенные к этому предыдущему потоку, должны повторно подключиться с использованием конфигурации V2.

Приложение Shopify Dev Dashboard

MakeCrypto автоматически создает приложение Dev Dashboard на основе токена Partner CLI. Имя приложения всегда MakePay. После его создания откройте настройки приложения MakePay на панели разработки и скопируйте секрет клиента в MakeCrypto.

Требуется администратор областей действия API:

• read_customers
• write_customers
• read_products
• write_products
• read_orders
• write_orders
• read_draft_orders
• write_draft_orders
• read_themes
• write_themes

Имя развернутого приложения Shopify всегда — MakePay.

Конфигурация MakeCrypto

Откройте MakeCrypto, выберите компанию и перейдите в раздел «Электронная коммерция» > «Shopify». Добавьте магазин с помощью:

• Маркер магазина Shopify, который находится перед .myshopify.com.
• Одноразовый токен Shopify Partner CLI
• Секрет клиента Shopify, скопированный после того, как MakeCrypto создает приложение.
• Название способа оплаты вручную

Токен партнерского CLI шифруется до тех пор, пока MakeCrypto не создаст, не развернет и не установит приложение, а затем он будет удален. Во время создания приложения MakeCrypto также определяет идентификатор организации Shopify Dev Dashboard из токена. Секрет клиента и автономный токен администратора API в хранении зашифрованы.

Чтобы создать партнерский токен CLI, откройте настройки партнерского портала Shopify, прокрутите вниз до пункта «Токен CLI», управляйте токенами и сгенерируйте новый. Его можно отозвать после успешного завершения установки приложения MakePay.

Установка и блоки checkout

Когда развертывание будет выглядеть как развернутое, откройте партнерский портал Shopify, выберите приложение, перейдите в раздел «Распространение» > «Пользовательское распространение» и установите приложение в магазине. Shopify перенаправляет обратно на MakeCrypto после установки.

Затем откройте администрацию Shopify и выберите «Настройки» > «Оформление заказа» > «Настроить». Добавьте блок MakePay на страницу «Спасибо» и страницу «Статус заказа» и сохраните.

Блок MakePay проверяет токен сеанса Shopify, запрашивает MakeCrypto для соответствующей ссылки платежа и отображает кнопку «Оплатить сейчас». Если запрос webhook все еще обрабатывается, блок некоторое время ждет, пока MakePay подготовит ссылку.

Ручной способ оплаты

В администраторе Shopify откройте «Настройки» > «Платежи» > «Способы оплаты вручную» и создайте собственный способ оплаты. Его имя должно точно совпадать с названием способа оплаты соединения MakeCrypto. Новые соединения MakePay по умолчанию используют:

Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others

Когда клиенты выбирают этот метод, Shopify создает заказ как неоплаченный. Синхронизация MakePay прикрепляет URL размещенного checkout к примечанию к заказу и может отправлять электронное письмо с запросом платежа MakePay, если она включена.

Вебхуки и синхронизация

MakeCrypto регистрирует webhooks создания/обновления заказа и удаления приложения после завершения установки версии 2. Запланированная синхронизация также проверяет недавно подключенные магазины, поэтому заказы принимаются, даже если доставка webhooks Shopify задерживается.

Входящие подписи webhooks от Shopify проверяются перед принятием payload. Журналы запросов и webhooks сохраняются на странице подключения для устранения неполадок.

Сопоставление статусов

Когда заказ Shopify находится на рассмотрении с использованием метода оплаты вручную MakePay, MakePay создает или повторно использует платежную ссылку MakePay для общей суммы заказа и адреса электронной почты клиента.

Когда платеж MakePay поступает на complete, MakePay добавляет оплаченное примечание/тег и использует orderMarkAsPaid от администратора Shopify API, когда включена автоматическая пометка платежа.

Когда платеж MakePay поступает на адрес failed, expired или cancelled, MakePay добавляет примечание о состоянии и оставляет неоплаченный заказ Shopify на рассмотрение merchant.

Устранение неполадок

Если создать или развернуть приложение не удалось, перед запуском задания убедитесь, что токен партнерского CLI начинается с atkn_ и не был отозван, а затем повторите попытку с MakeCrypto.

В случае сбоя установки убедитесь, что приложение Shopify было создано с той же конфигурацией MakeCrypto и что приложение URL, созданное MakeCrypto, настроено при развертывании.

Если тестовое соединение не удалось, убедитесь, что приложение имеет все необходимые области, и переустановите или повторно разверните приложение.

Если блок «Оплатить сейчас» остается готовым, убедитесь, что блок MakePay установлен на обеих страницах checkout и что в заказе Shopify используется именно имя метода оплаты вручную.