Brama MakePay Invision Community

Przegląd

Oficjalna aplikacja MakePay Invision Community dodaje hostowane kryptowaluty checkout do Invision Community 5 Handel. Commerce tworzy fakturę i transakcję, MakePay tworzy hostowane łącze do płatności, a podpisany webhooks aktualizuje transakcji po zdarzeniach płatniczych.

Do normalnej konfiguracji użyj Connect MakePay. Pozostają ręczne poświadczenia klucza API dostępny jako rezerwowy.

Zanim zaczniesz

• Invision Community 5.0 lub nowszy
• Zainstalowana aplikacja handlowa
• PHP 8.1 lub nowszy
• Adres URL społeczności HTTPS
• Firma MakePay, w której możesz zarządzać ustawieniami płatności

Zainstaluj aplikację

Pobierz najnowszy pakiet TAR:

https://plugins.makecrypto.io/downloads/invision-community/latest.tar

Zainstaluj go z menedżera aplikacji Invision AdminCP.

Podłącz MakePay

Otwórz ustawienia płatności Commerce i dodaj MakePay jako metodę płatności. Wybierz Podłącz MakePay. Aplikacja:

1. Otwiera MakeCrypto na karcie przeglądarki.
2. Prosi Cię o zalogowanie się i wybranie firmy, która ma otrzymywać płatności.
3. Pokazuje uprawnienia wymagane przez bramę Invision Community.
4. Po zatwierdzeniu zwraca Cię do Invision.
5. Zapisuje połączenie społecznościowe w zaszyfrowanych ustawieniach Invision.
6. Konfiguruje adres URL wywołania zwrotnego MakePay webhook.

Skonfiguruj MakePay

Po nawiązaniu połączenia pozostaw metodę połączenia ustawioną na domyślny tryb połączenia. Recenzja:

• Dostępność metody płatności
• Identyfikator firmy MakePay
• Adres URL wywołania zwrotnego Webhook
• Rejestrowanie debugowania/żądań
• Ręczne poświadczenia zastępcze klucza API

Ręczne przywracanie awaryjne wymaga identyfikatora firmy MakePay, identyfikatora klucza API, tajnego klucza API oraz Sekret webhook.

Przepływ Checkout

Kiedy członek wybierze MakePay, Invision tworzy transakcję handlową i aplikacja tworzy link do płatności MakePay z metadanymi faktury.

Pole	Zamiar
source=invision	Identyfikuje integrację
externalId=invision_invoice_<id>	Mapuje aktywność MakePay z powrotem do handlu
invoiceId	Identyfikator faktury Invision Commerce
transactionId	Identyfikator transakcji Invision Commerce
moduleVersion	Zainstalowana wersja aplikacji MakePay

Członek zostaje przekierowany do hostowanego MakePay checkout i wraca do społeczności po dokonaniu płatności lub anulowaniu.

Stany handlowe

Punkt końcowy webhook weryfikuje X-MakePay-Signature przed zmianą opcji Handel stan transakcji.

Stan MakePay	Stan transakcji Invision
paid, completed, confirmed, succeeded	Zatwierdzony
failed, expired	Odrzucony
cancelled, canceled	Odrzucony
refunded	Zwrócono pieniądze
Inne statusy	Aż do

Każdy webhook zapisuje prywatną wiadomość na fakturze ze statusem MakePay, płatnością UID i adres URL hostowanej płatności, jeśli jest dostępny.

Uwagi dotyczące bezpieczeństwa

Aplikacja przechowuje szczegóły połączenia w zaszyfrowanych ustawieniach Invision. Zachowaj Dostęp AdminCP ograniczony do zaufanych operatorów i odłącz bramę MakeCrypto, jeśli ujawniono kopię zapasową konta administratora lub serwera.

Połączenie prosi o następujące uprawnienia:

• company:read
• makepay:payment-links:read
• makepay:payment-links:write
• makepay:customers:read
• makepay:customers:write
• makepay:settings:read
• makepay:settings:write

Rozwiązywanie problemów

Jeśli nie można uruchomić Connect MakePay, potwierdź, że podstawowy adres URL społeczności to HTTPS i publicznie osiągalne. Jeśli przekierowania checkout nie powiodą się, potwierdź, że opcja Commerce działa zainstalowany i MakePay ma zapisane połączenie lub ręczne przywrócenie klucza API referencje. Jeśli faktury nie aktualizują się, porównaj wywołanie zwrotne MakePay webhook URL z adresem URL społeczności webhook i obróć klucz tajny webhook.