Płatności Dojo dla OpenMage/Magento 1

Podłącz sklep OpenMage / Magento 1 do Dojo Payments bez przebudowy checkoutu. Klient płaci na stronie Dojo i wraca do sklepu — status zamówienia aktualizuje się automatycznie.

Co robi moduł?
Septsite_Dojo dodaje metodę płatności Dojo w checkout Magento. Po złożeniu zamówienia tworzy Payment Intent w Dojo, przekierowuje na paymentLink, a potem aktualizuje zamówienie na podstawie powrotu, anulowania i webhooka (payment_intent.status_updated).

Kluczowe korzyści

Płatność na stronie Dojo
Dane karty i portfeli obsługuje hosted checkout Dojo. Sklep zachowuje flow Magento, a UI płatności zostaje po stronie Dojo.

Karty i portfele w jednej metodzie
W konfiguracji wybierasz metody Dojo: Card, Wallet (Apple Pay / Google Pay — gdy włączone w koncie Dojo i dostępne u klienta) oraz Saved Card.

Status zamówienia z Dojo
Zamówienie uznajemy za opłacone dopiero przy statusie Captured. Authorized pozostaje w oczekiwaniu na płatność. Powtórzone webhooki są obsługiwane idempotentnie — bez duplikowania faktur.

Bezpieczniejsze callbacki
Walidacja podpisu webhooka (HMAC-SHA256 / Dojo-Signature) może być wymagana; sekret webhooka jest przechowywany w zaszyfrowanej konfiguracji Magento.

Dla kogo
Sklepy OpenMage i Magento 1, które chcą Dojo jako metodę z przekierowaniem w one-page checkout — zwłaszcza gdy mają (lub planują) konto Dojo (sandbox lub produkcja).

Główne funkcje

Metoda płatności dojo w checkout (System → Configuration → Payment Methods → Dojo Payments)
Tworzenie Payment Intent przez API Dojo i przekierowanie na paymentLink
Endpointy: redirect, return, notify, cancel
Tryb capture wysyłany do Dojo: Auto lub Manual
Dozwolone metody: Card, Wallet, SavedCard
Zaszyfrowany klucz API i sekret webhooka
Opcjonalne logi debug do var/log/dojo.log
Opcjonalne wymuszanie poprawnego podpisu webhooka
Ograniczenie krajów i sortowanie jak w standardowych metodach Magento
Oznaczenie opłacenia / faktury przy Captured; obsługa anulowania płatności

Kompatybilność i wymagania

Platforma: OpenMage / Magento 1 (dokładny zakres wersji: TODO — potwierdź na swoim stacku)
Wersja modułu: 0.1.0
Konto Dojo (sandbox sk_sandbox_… lub produkcja sk_prod_…)
Publiczny HTTPS dla webhooka: https://twoja-domena/dojo/processing/notify
Subskrypcja webhooka Dojo: payment_intent.status_updated
Nagłówek wersji API Dojo konfigurowalny (domyślnie w module: 2026-02-27)

Ważne informacje

To wczesne wydanie MVP (0.1.0). Przed produkcją przetestuj dokładnie w sandbox Dojo.
Zwrot, capture i void/reversal z panelu Magento nie są jeszcze dostępne (planowane później). Tryb Capture można ustawić dla Payment Intent w API, ale capture z BO Magento w tej wersji nie działa.
Dostępność Wallet (Apple Pay / Google Pay) zależy od konta Dojo oraz urządzenia i przeglądarki klienta.
W produkcji trzymaj włączoną walidację podpisu webhooka; nie mieszaj kluczy produkcyjnych z sandbox.

Instalacja (skrót)

Wgraj pliki (app/code/local/Septsite/Dojo oraz app/etc/modules/Septsite_Dojo.xml).
Wyczyść cache Magento; włącz Dojo Payments w konfiguracji.
Uzupełnij klucz API, wersję API, tryb capture, metody i sekret webhooka.
Zarejestruj URL notify w Dojo Developer Portal i przejdź płatności testowe (sukces, anulowanie, webhook).