Niestandardowa aplikacja Shopify

Model integracji

Integracja Shopify wykorzystuje przepływ aplikacji Shopify V2 Dev Dashboard. The sprzedawca udostępnia token CLI partnera Shopify raz, aby MakeCrypto mógł utworzyć naprawiono aplikację MakePay w Shopify Dev Dashboard z Shopify CLI. MakeCrypto czyta automatycznie wygenerowany identyfikator klienta. Shopify nadal ujawnia sekret Klienta tylko w panelu deweloperskim, więc sprzedawca kopiuje ten sekret do MakeCrypto przed wdrożeniem.

Po wdrożeniu i zainstalowaniu aplikacji Shopify uruchamia MakeCrypto z podpisany token sesji. MakeCrypto sprawdza ten token za pomocą klucza tajnego Klienta i wymienia go na token offline Admin API. Ten token jest szyfrowany w stanie spoczynku i używany do tego samego przepływu pracy zamówienia MakePay, co poprzednio: synchronizacja zamówień, płatność hostowana linki, notatki/tagi, webhooks i opcjonalna automatyzacja z opłatą za markę.

Konfiguracja tokenu dostępu starszego administratora API nie jest już obsługiwana w przypadku nowego Shopify połączenia. Istniejące sklepy połączone ze starszym przepływem muszą zostać ponownie połączone poprzez konfigurację V2.

Aplikacja panelu deweloperskiego Shopify

MakeCrypto automatycznie tworzy aplikację Dev Dashboard z poziomu interfejsu CLI partnera żeton. Nazwa aplikacji to zawsze MakePay. Po utworzeniu otwórz aplikację MakePay ustawienia w Dev Dashboard i skopiuj klucz tajny klienta do MakeCrypto.

Wymagane zakresy administracyjne API:

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

Nazwa wdrożonej aplikacji Shopify to zawsze MakePay.

Konfiguracja MakeCrypto

Otwórz MakeCrypto, wybierz firmę, a następnie przejdź do E-commerce > Shopify. Dodaj sklep z:

• Shopify przechowuje ślimak, który jest częścią poprzedzającą .myshopify.com
• jednorazowy token CLI partnera Shopify
• Shopify Sekret klienta skopiowany po utworzeniu aplikacji przez MakeCrypto
• nazwa metody płatności ręcznej

Token Partner CLI jest szyfrowany do czasu utworzenia, wdrożenia i wdrożenia MakeCrypto instaluje aplikację, a następnie zostaje wyczyszczona. Podczas tworzenia aplikacji MakeCrypto również wykrywa identyfikator organizacji Shopify Dev Dashboard z tokena. Klient Tajny i offline token administratora API są szyfrowane w stanie spoczynku.

Aby wygenerować token Partner CLI, otwórz ustawienia portalu partnerów Shopify i przewiń do Token CLI, zarządzaj tokenami i generuj nowy token. Można je odwołać po Instalacja aplikacji MakePay powiodła się.

Zainstaluj i bloki checkout

Gdy stanowisko zostanie wyświetlone jako wdrożone, otwórz portal partnera Shopify i wybierz aplikację, przejdź do Dystrybucja > Dystrybucja niestandardowa i zainstaluj aplikację na sklep. Shopify przekierowuje z powrotem do MakeCrypto po instalacji.

Następnie otwórz panel administracyjny Shopify i przejdź do Ustawienia > Checkout > Dostosuj. Dodaj MakePay na stronie z podziękowaniami i na stronie Status zamówienia, a następnie zapisz.

Blok MakePay weryfikuje token sesji Shopify, pyta MakeCrypto o pasujący link do płatności i wyświetla przycisk Zapłać teraz. Jeśli zamówienie webhook to nadal przetwarzany, blok czeka krótko, podczas gdy MakePay przygotowuje łącze.

Ręczna metoda płatności

W panelu administracyjnym Shopify otwórz Ustawienia > Płatności > Ręczne metody płatności i utwórz plik niestandardową metodę płatności. Jego nazwa musi dokładnie odpowiadać połączeniu MakeCrypto nazwa metody płatności. Nowe połączenia MakePay domyślnie mają:

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

Gdy klienci wybiorą tę metodę, Shopify tworzy zamówienie jako niezapłacone. MakePay synchronizacja dołącza hostowany adres URL checkout do notatki o zamówieniu i może wysłać MakePay E-mail z prośbą o płatność, jeśli jest włączony.

Webhooks i synchronizacja

MakeCrypto rejestruje polecenie utworzenia/aktualizacji i odinstalowania aplikacji webhooks po Instalacja wersji 2 została zakończona. Zaplanowana synchronizacja sprawdza także ostatnio połączone sklepy, tzw zamówienia są nadal odbierane, jeśli dostawa Shopify webhook jest opóźniona.

Przychodzące podpisy Shopify webhook są weryfikowane przed przyjęciem ładunku. Dzienniki żądań i webhook są przechowywane na stronie połączenia w celu rozwiązywania problemów.

Mapowanie stanu

Gdy zamówienie Shopify oczekuje na realizację za pośrednictwem metody płatności ręcznej MakePay, MakePay tworzy lub ponownie wykorzystuje łącze płatnicze MakePay dla kwoty zamówienia i e-mail klienta.

Gdy płatność MakePay osiągnie complete, MakePay doda opłaconą notatkę/znacznik i używa Shopify Admin API orderMarkAsPaid, gdy włączone jest automatyczne oznaczanie jako opłacone.

Gdy płatność MakePay osiągnie poziom failed, expired lub cancelled, MakePay dodaje notatkę o statusie i pozostawia zamówienie Shopify niezapłacone w celu sprawdzenia przez sprzedawcę.

Rozwiązywanie problemów

Jeśli utworzenie lub wdrożenie aplikacji nie powiedzie się, potwierdź, że token Partner CLI zaczyna się od atkn_ i nie zostało odwołane przed rozpoczęciem zadania, spróbuj ponownie MakeCrypto.

Jeśli instalacja nie powiedzie się, potwierdź, że aplikacja Shopify została utworzona przez tego samego MakeCrypto setup i że wygenerowany adres URL aplikacji MakeCrypto jest konfigurowany podczas wdrażania.

Jeśli połączenie testowe nie powiedzie się, sprawdź, czy aplikacja ma wszystkie wymagane zakresy i zainstaluj ponownie lub ponownie wdróż aplikację.

Jeśli blok Zapłać teraz pozostaje w stanie przygotowania, potwierdź, że blok MakePay jest zainstalowany na obu stronach checkout i że zamówienie Shopify używa dokładnej nazwa metody płatności ręcznej.