Brama Wix Velo

Przegląd

MakePay dla Wix korzysta z wtyczki usługi dostawcy płatności Wix Velo. Kupiec dodaje cztery pliki MakePay JavaScript do edytora Wix, instaluje crypto-js, łączy dostawcę płatności w Ustawienia > Akceptuj płatności i przechowuje API wpisy tajne w Menedżerze sekretów Wix.

W checkout Wix wywołuje createTransaction(). Tworzy się plik backendu MakePay hostowany link do płatności MakePay i zwraca adres URL przekierowania do Wix. Kiedy MakePay potwierdza płatność, podpisany webhook wywołuje funkcję HTTP Wix i kod rejestruje płatność na zamówieniu Wix.

Zanim zaczniesz

Będziesz potrzebować:

• Sklep Wix z włączonym trybem programisty
• Zezwolenie na edycję plików backendu Velo i wtyczek usług
• Zezwolenie na używanie Menedżera sekretów Wix
• Firma MakeCrypto ze skonfigurowanym rozliczeniem MakePay
• Klucz MakePay API z dostępem do zapisu łącza płatniczego
• Sekret MakePay webhook dla firmy

Utwórz poświadczenia MakePay

W MakeCrypto:

1. Wybierz firmę, która ma otrzymać płatności Wix.
2. Otwórz Portfel > Salda i skonfiguruj rozliczenie.
3. Otwórz Integracje > Integracje API i utwórz klucz API.
4. Podaj klucz przynajmniej:
   • makepay:payment-links:read
   • makepay:payment-links:write
5. Skopiuj identyfikator firmy, identyfikator klucza API i klucz tajny klucza API.
6. Otwórz Sprzedawca > Ustawienia płatności i zmień lub skopiuj sekret webhook.

Klucz tajny API i sekret webhook są dodawane do Menedżera sekretów Wix, a nie do kod frontendu.

Dodaj pliki Wix Velo

Otwórz repozytorium źródłowe MakePay Wix:

https://github.com/makecryptoio/makepay-wix

To samo źródło jest utrzymywane w tym monorepo pod apps/plugins/wix.

W Wix:

1. Otwórz edytor witryny i włącz Tryb deweloperski.
2. W obszarze Publiczne i backend > Backend utwórz:
   • MakePay.js
   • http-functions.js
3. W sekcji Wtyczki serwisowe utwórz wtyczkę Płatności o nazwie MakePayPayment.
4. Kopia:
   • MakePayPayment-config.js
   • MakePayPayment.js
5. Zainstaluj pakiet crypto-js npm z Pakiety i aplikacje.
6. Opublikuj witrynę.

Dodaj wpisy tajne Wix

Otwórz Narzędzia dla programistów > Menedżer sekretów i dodaj:

Sekretne imię	Wartość
makepay_api_key_secret	Tajny klucz klucza MakePay API
makepay_webhook_secret	Sekret MakePay webhook

Nie wklejaj tych wartości do kodu strony ani do publicznych plików frontonu.

Podłącz MakePay do Wix

Otwórz Ustawienia > Akceptuj płatności w panelu kontrolnym Wix i podłącz niestandardowy Dostawca płatności MakePay.

Wchodzić:

Pole	Wartość
Identyfikator firmy MakePay	Identyfikator firmy MakeCrypto
MakePay API identyfikator klucza	Identyfikator klucza MakePay API
Waluta rozliczeniowa	Zwykle USDT

Tytuł metody płatności checkout to:

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

Skonfiguruj webhooks

Punkt końcowy funkcji HTTP Wix to:

https://your-wix-domain.com/_functions/makepay_notify

W MakeCrypto otwórz Sprzedawca > Ustawienia płatności i ustaw wywołanie zwrotne MakePay Adres URL do tego punktu końcowego. Sekret webhook w Menedżerze sekretów Wix musi pasować do Sekret MakePay webhook.

Procedura obsługi Wix webhook weryfikuje nagłówek X-MakePay-Signature przed oznacza każde zamówienie jako opłacone.

Przetestuj checkout

1. Dodaj produkt o niskiej wartości do koszyka Wix.
2. Przejdź do checkout.
3. Wybierz metodę płatności kryptowalutą MakePay.
4. Kliknij Złóż zamówienie i zapłać.
5. Potwierdź, że Wix przekierowuje do hostowanego MakePay checkout.
6. Dokonaj płatności testowej.
7. Po otrzymaniu webhook potwierdź, że zamówienie Wix zostało oznaczone jako opłacone.
8. Sprawdź Integracje > Żądania Webhook w MakeCrypto, jeśli zamówienie tak nie aktualizować.

Uwagi dotyczące bezpieczeństwa

Integracja Wix wykorzystuje uwierzytelnianie za pomocą klucza API, ponieważ Velo skopiowane przez sprzedawcę Pliki dostawców płatności nie obsługują automatycznego przepływu Connect MakePay jeszcze.

Zachowaj te zasady:

• Przechowuj sekrety tylko w Menedżerze sekretów Wix.
• Użyj klucza API specyficznego dla MakePay, a nie szerokiego klucza wewnętrznego.
• Nie udzielaj zakresów zarządzania portfelem ani API-key.
• Obróć klucz API i klucz tajny webhook, jeśli ktoś ma dostęp do starego edytora Wix nie powinien już zarządzać płatnościami.
• Zachowaj adres URL wywołania zwrotnego HTTPS i publiczny.

Rozwiązywanie problemów

Jeśli dostawca nie pojawia się w Akceptuj płatności, potwierdź, że usługa wtyczka nazywa się MakePayPayment, istnieją dwa pliki wtyczek i witryna je ma opublikowano po dodaniu kodu.

Jeśli Połączenie nie powiedzie się, potwierdź, że makepay_api_key_secret istnieje w Wix Menedżer sekretów i że identyfikator klucza/identyfikatora firmy API jest zgodny z tym samym identyfikatorem MakeCrypto firma.

Jeśli checkout nie przekierowuje, sprawdź dzienniki Wix Velo pod kątem createTransaction błąd i potwierdź, że klucz API ma makepay:payment-links:write.

Jeśli zamówienia nie zostaną zaktualizowane, potwierdź, że adres URL wywołania zwrotnego MakeCrypto to https://your-wix-domain.com/_functions/makepay_notify, sekret webhook pasują, a dzienniki dostaw MakeCrypto webhook pokazują odpowiedź 2xx.