1. Wstęp
Zapoznajesz się z dokumentem, który zawiera podstawowe informacje na temat środowiska testowego Sandbox – usługi bramki płatniczej Tpay przeznaczonej do testowania integracji.
Funkcjonalności środowiska Sandbox są mocno zbliżone do środowiska produkcyjnego. Rozwiązanie korzysta z niezależnej od produkcji bazy danych, a kwoty pieniężne widoczne w Sandboxie, np. salda, nie są rzeczywistymi środkami pieniężnymi.
Różnice pomiędzy środowiskiem produkcyjnym a Sandboxem opisuje ten dokument.
2. Rejestracja
Z Sandboxa mogą korzystać wyłącznie zarejestrowani użytkownicy: https://register.sandbox.tpay.com.
Proces rejestracji przebiega tak samo, jak zakładanie konta produkcyjnego:
- Na https://register.sandbox.tpay.com należy wypełnić formularz – podać adres e-mail oraz nazwę firmy.
- Następnie kliknąć w link aktywacyjny obecny w wiadomości wysłanej na wskazany adres mailowy.
- Na koniec ustala się hasło do swojego konta.
Na potrzeby Sandboxa proces weryfikacji jest wyłączony, dlatego z konta można korzystać od razu po rejestracji.
3.Przydatne linki
Środowisko Sandbox dostępne jest w subdomenie sandbox.tpay.com, aby odróżnić je od produkcyjnego serwisu Tpay.
Przydatne linki:
4. Dostęp
Środowisko Sandbox umożliwia przetestowanie funkcjonalności serwisu Tpay wszystkimi możliwymi metodami integracji – zarówno płatności poprzez link, jak i z użyciem API.
Zalecamy wykorzystanie Open API do komunikacji ze środowiskiem Sandbox, ale w celu zachowania wstecznej kompatybilności, dajemy również dostęp do starego API.
Open API
W celu uzyskania dostępu do serwisu Sandbox za pomocą Open API, należy w Panelu Akceptanta Sandbox przejść do sekcji Integracje > API. Dane niezbędne do autoryzacji, będą dostępne w pierwszej sekcji.
Origin API
W celu uzyskania dostępu do serwisu Sandbox za pomocą Origin API, należy w Panelu Akceptanta Sandboxprzejść do sekcji Integracja > API. Dane niezbędne do autoryzacji będą dostępne w drugiej sekcji.
Link do płatności
W celu wygenerowania linku do płatności, czyli spreparowania żądania płatności, należy przejść do sekcji Linki do płatności.
Wypełnienie formularza skutkuje otrzymaniem zestaw linków do płatności (normalnego oraz skróconego [hash]), jak również formularza w HTML do wstawienia bezpośrednio na stronie sprzedawcy.
5. Funkcjonalności
Użytkownicy Sandbox mają możliwość przetestowania wszystkich dostępnych funkcjonalności – są one domyślnie włączone dla wszystkich zarejestrowanych kont.
Różnice między środowiskiem produkcyjnym a Sandbox wynikają ze specyfiki środowiska testowego, w tym z braku połączenia z systemami zewnętrznych dostawców (np. banków), lub ograniczenia wpływu testów na rzeczywistych użytkowników (np. domyślne zablokowanie wysyłania maili do płatników).
Uwaga!
Nie wszystkie kanały płatności są dostępne dla wszystkich użytkowników. Zależy to w dużej mierze od etapu procesu weryfikacji danego sprzedawcy, jak również od zewnętrznych dostawców.
W przypadku pytań zachęcamy do kontaktu poprzez formularz znajdujący się w Panelu Sandboxa.
6.Kanały płatności
Płatności kartami
Na potrzeby środowiska Sandbox przygotowaliśmy zestaw testowych kart płatniczych. Nie jest możliwe przeprowadzenie transakcji z udziałem kart o innych numerach.
Testowy numer karty płatniczej |
2223 0002 8000 0016 |
4056 2178 4359 7258 |
5204 7400 0000 1002 |
5457 2100 0200 1016 |
4012 0010 3714 1112 |
4911830000000 |
4000 001 2345 6234 5678 |
Dodatkowo istnieje możliwość przetestowania walidacji 3DS według następujących reguł:
- kwota zakończona na 1 (grosze) –frictionless (płatność bez dodatkowego potwierdzania przez 3DS), np. 5.21
- kwota zakończona na 3 –method notification zakończone sukcesem (5.23)
- kwota zakończona na 5 –method notification zakończone błędem (5.25)
- kwota zakończona na 6 –decline (5.26)
- kwota zakończona na inną wartość powoduje przekierowanie na challenge (wymuszenie 3DS, np. 5.27, 5.24)
Niezależnie od powyższych kwot na Sandboxie istnieje kilka sztywnych kwot wywołujących błędy:
- przy płatnościach kartowo-walletowych (karta, token, Google Pay, VISA MOBILE, Apple Pay) - 500.00, 501.00, 503.00
- przy płatnościach wyłącznie tokenem również 504.00
Visa Mobile
Na sandboxie istnieje opcja testowania zarówno formy on-site (z przekazaniem numeru telefonu w payloadzie) jak i zwykłej (podanie danych na formularzu).
- (48) 12345678904 - telefon nieobsługiwany przez Visa Mobile
- każdy inny - telefon akceptowany
- akcja - kwota
- inna niż poniższe - natychmiastowa akceptacja transakcji w Visa Mobile przez płatnika
- 201.00 - akceptacja transakcji w Visa Mobile przez płatnika po upływie 120s
- 202.00 - płatnik nie podejmuje żadnej akcji na pop-upie Visa Mobile - upływa przewidziany czas 5 minut
- 203.00 i 204.00 - akceptacja transakcji w Visa Mobile przez płatnika po upływie 180s
- 499.00 - natychmiastowe odrzucenie transakcji w Visa Mobile przez płatnika
- 500.00, 501.00, 503.00, 600.00 - kwoty wywołujące błędy.
Google Pay - karty testowe
W celu poprawnego przetestowania integracji Google Pay z Tpay na środowisku Sandbox, wykorzystaj pakiet kart testowych Google.
Karty testowe Google umożliwiają:
Jeżeli chcesz skorzystać z kart testowych:
1. Zapisz się do grupy użytkowników pakietów kart testowych: https://groups.google.com/forum/?hl=pl#!forum/googlepay-test-mode-stub-data
2. Po wejściu na stronę kliknij w przycisk “Dołącz do grupy”:
3. Następnie, po odświeżeniu strony, wyświetli się informacja o pozytywnym nadaniu dostępu:
4. Od teraz masz dostęp do kart testowych!
Uwaga!
- Pakiet kart testowych jest przeznaczony do użytku tylko w środowiskach TEST.
Pamiętaj, aby poprawnie ustawić zmienną środowiskową ({environment: 'TEST'})
Apple Pay
Istnieje możliwość testowania Apple Pay. Do tego niezbędne jest otworzenie linku do stworzonej transakcji na urządzeniu iOS ze skonfigurowanym portfelem Apple Pay i dodaną rzeczywistą kartą płatniczą. Karta nie jest w procesie obciążana. Jednocześnie obsługiwane są jak w przypadku kart i Google Pay kwoty błędów 500.00, 501.00, 503.00.
Płatności BLIK
Testowanie płatności z wykorzystaniem kanału BLIK wymaga podania kodu autoryzacyjnego. Dla płatności testowych poprawny kod autoryzacyjny musi zaczynać się od 777, np. 777654.
Funkcjonują również kwoty testowe, które nawet w przypadku podania prawidłowego kodu (tj. z 777 na początku), powodują zwrócenie błędu z systemu Polskiego Standardu Płatności (dostawcy systemu BLIK) w tzw. odpowiedzi asynchronicznej (płatność przyjęta jest do realizacji, ale po chwili odrzucona). Są to:
Dla płatności BLIK istnieje możliwość wykorzystania requestów do Open API w celu wygenerowania i opłacenia transakcji:
Zwykłe płatności można rozszerzyć o zapisanie aliasu użytkownika, umożliwiając mu płatność bez konieczności podawania kodu BLIK następnym razem. Alias jest unikatowym ciągiem znaków generowanym w systemie merchanta, typ aliasu to UID.
Po udanym zarejestrowaniu aliasu można wykonać kolejną płatność bez podawania kodu BLIK, a tylko z samym aliasem.
Przelew natychmiastowy (online, szybki)
W celu przetestowania działania tej metody płatności, należy w bramce płatniczej wybrać opcję Bank Transfer, a następnie bank, w którym ma być sfinalizowana płatność.
Środowisko Sandbox odwzorowuje zachowanie produkcyjne, dlatego w przypadku ścieżki negatywnej pojawi się komunikat o oczekiwaniu na płatność, ponieważ banki nie przesyłają informacji o porzuconej płatności.
7. Dokumentacja
Dokumentacja Open API:https://openapi.tpay.com
Dokumentacja Origin API:https://docs.tpay.com
