Testowanie i wdrożenie na produkcję
Na tej stronie przetestujesz integrację SDK w sandboxie i przejdziesz checklistę przed włączeniem płatności dla prawdziwych klientów.
Przygotuj sandbox
- Wczytaj SDK z hosta
https://cards.sandbox.paymentic.comi w konfiguracji podaj sandboxowy Point ID. Zob. Instalacja i inicjalizacja. - Jeśli Twoja strona ma CSP, dopuść host sandboxowy: Content Security Policy.
- Obsłuż webhook
PAYMENT.TRANSACTION_STATUS_CHANGED, bo część scenariuszy kończy się dopiero webhookiem. Zob. Zmiana statusu transakcji.
Karty i scenariusze testowe
Numery kart, kwoty wymuszające odrzucenie, karty do challenge'u 3-D Secure oraz karty testowe Google Pay są wspólne dla SDK i strony płatności Paymentic. Znajdziesz je na stronie Testowanie kart. W hosted fields podajesz je dokładnie tak samo jak na stronie płatności: numer, dowolną przyszłą datę ważności i dowolny 3-cyfrowy CVC.
Dla portfeli w SDK obowiązuje dodatkowo:
- Google Pay: z sandboxowym Point ID arkusz działa w środowisku
TESTGoogle. Dla przycisku natywnego nie rejestrujesz żadnej domeny. - Apple Pay: weryfikacja domeny u Apple jest potrzebna również w sandboxie; zob. Apple Pay.
Przećwicz ścieżki błędów SDK
- Wyślij formularz z niekompletną kartą:
tokenize()zwracaINVALID_CARD. - Odczekaj ponad 60 sekund przed wykorzystaniem tokenu: Payment API odrzuca token.
- Zamknij arkusz portfela: przychodzi zdarzenie
cancel. - Ukryj kontener przycisku portfela i sprawdź, że
mountGooglePay/mountApplePayzwracająavailable: falsez powodem, a nie rzucają błędu.
Kody błędów SDK opisuje strona Błędy i rozwiązywanie problemów.
Przed produkcją
Przejdź tę listę, zanim włączysz płatności kartą i portfelami dla prawdziwych klientów.
- Checkout serwowany po HTTPS, łącznie z każdą subdomeną, która pokazuje formularz.
- Produkcyjny Point ID w SDK, SDK wczytywane z
https://cards.paymentic.com/sdk/v1/…i produkcyjny token API na backendzie. - CSP dopuszcza domeny z Content Security Policy, jeśli używasz CSP.
- Apple Pay: plik powiązania domeny hostowany, a weryfikacja potwierdzona przez Paymentic.
- Własny przycisk Google Pay: każda domena checkoutu przekazana Paymentic do rejestracji w Google.
- Kontenery portfeli ukryte, gdy
available === false(wymagają tego wytyczne marki Google i Apple). -
jwtwysyłany tylko do Twojego backendu, po HTTPS, i wykorzystywany w ciągu 60 s. - Backend wysyła token do
POST .../transactions/{transactionId}/cardsz danymi przeglądarki, a challenge 3-D Secure znextActionjest pokazywany płatnikowi (zob. Zrealizuj płatność tokenem). - Handlery
erroricancelpokazują klientowi, co się stało, i pozwalają spróbować ponownie. -
destroy()podpięte do odmontowania checkoutu w aplikacji SPA. - Diagnostyka z
loggerkierowana do Twojego monitoringu. - Webhook
PAYMENT.TRANSACTION_STATUS_CHANGEDobsłużony, a zamówienie realizowane dopiero po statusiePAID(zob. Statusy transakcji).