Środowisko testowe – Sandbox

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:

1. Na https://register.sandbox.tpay.com  należy wypełnić formularz – podać adres e-mail oraz nazwę firmy. 
2. Następnie kliknąć w link aktywacyjny obecny w wiadomości wysłanej na wskazany adres mailowy.
3. 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:

• Formularz rejestracyjny: https://register.sandbox.tpay.com 
• Panel Sandbox: https://panel.sandbox.tpay.com 
• Panel Partnera:https://partner.sandbox.tpay.com 
• Bramka płatnicza i Origin API: https://secure.sandbox.tpay.com 
• Bramka kartowa: https://cards.sandbox.tpay.com 
• Open API: https://openapi.sandbox.tpay.com 

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).

Acquirer Kartowy

Obecnie płatności kartowe obsługiwane są przez dwóch acquirerów: Pekao i Elavon. Domyślnie, podczas rejestracji konta Sandbox, płatności kartowe realizowane są za pośrednictwem acquirera Pekao. Jeśli chcesz przetestować integrację z wykorzystaniem acquirera Elavon, skontaktuj się z Biurem Obsługi Klienta (BOK).

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.

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

Wielowalutowe Płatności kartami

Na środowisku sandbox istnieje możliwość przetestowania płatności kartowych w różnych walutach. W tym celu należy skorzystać z dedykowanej bramki kartowej (Cards API). Szczegóły znajdziesz tutaj:Tpay Cards API Introduction.

Aby przetestować funkcjonalność, skorzystaj z klucza API (api_key) dostępnego w Panelu Akceptanta w sekcji Integracja > API. Dane niezbędne do autoryzacji znajdują się w drugiej sekcji.

Obecnie dla transakcji wielowalutowych w środowisku Sandbox nie ma możliwości przetestowania scenariuszy specyficznych dla kart płatniczych, takich jak dodatkowe walidacje 3DS czy kwoty generujące błędy.

W transakcjach walutowych na Sandboxie można używać dowolnych numerów kart, CVV oraz dat ważności (expiry date).

Visa Mobile

Na sandboxie jest możliwość testowania zarówno rozwiązania on-site (z przekazaniem numeru telefonu w payloadzie) jak i zwykłej (podanie danych dopiero po przekierowaniu na formularz Visa Mobile w Tpay). 

O integracji w wersji on-site przeczytaj na stronie Jak wdrożyć Visa Mobile on-site

Dane do testowania:

Numery telefonu:

• (48) 12345678904 - numer nieobsługiwany przez Visa Mobile
• każdy inny numer - akceptowany
• akcja - kwota

Wartości transakcji umożliwiające przetestowanie różnych scenariuszy:

• 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
• każda inna - natychmiastowa akceptacja transakcji w Visa Mobile przez płatnika.

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ą:

• przetestowanie procesu płatności bez podawania danych prawdziwej karty płatniczej,
• pozytywne ukończenie zadań z listy kontrolnej integracji Google, co jest niezbędne do uzyskania dostępu produkcyjnego:  https://developers.google.com/pay/api/web/guides/test-and-deploy/integration-checklist?hl=pl#tesing-your-integration

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:

• Płatność podstawowa: https://support.tpay.com/pl/case-study/wdrozenie-metody-blik 
• Płatność BLIK One Click: https://support.tpay.com/pl/case-study/wdrozenie-metody-blik 

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 nowego API (Open API):https://openapi.tpay.com

Dokumentacja starego API (Origin API):https://docs.tpay.com