SimPay na Androidzie: gotowy ekran płatności w Twojej aplikacji

Udostępniamy SimPay Checkout Android SDK, bibliotekę z gotowym ekranem płatności dla aplikacji na Androida. Klient wybiera metodę płatności w aplikacji. Kod BLIK wpisuje w tym samym arkuszu, a przy metodach wymagających przekierowania przechodzi do przeglądarki i wraca do aplikacji po zakończeniu płatności.

SDK jest dostępne w Maven Central jako pl.simpay:checkout-android:1.0.0. Kod źródłowy i aplikację demonstracyjną znajdziesz w repozytorium simpay-android.

Co robi biblioteka?

SDK pobiera dostępne kanały płatności, wyświetla je w arkuszu wysuwanym od dołu ekranu i tworzy transakcję dla wybranej metody. Obsługuje BLIK Level 0 oraz kanały z przekierowaniem otwieranym w Custom Tab. Następnie sprawdza status transakcji przez API i przekazuje wynik do aplikacji.

Nie musisz samodzielnie budować listy kanałów, formularza kodu BLIK ani mechanizmu odpytywania o status. Nadal odpowiadasz za integrację swojego backendu, powrót z przeglądarki oraz powiązanie płatności z zamówieniem.

Ekran płatności ma polskie i angielskie teksty, wybierane zgodnie z językiem urządzenia. Biblioteka obsługuje Androida od wersji 5.0, czyli API 21. Projekt aplikacji musi korzystać z compileSdk co najmniej 34 i zgodności kodu Java 11.

Jak dodać SDK do aplikacji?

Jeśli projekt ma już skonfigurowane repozytoria google() i mavenCentral(), dodaj zależność w pliku build.gradle.kts modułu aplikacji:

dependencies {
  implementation(
    "pl.simpay:checkout-android:1.0.0"
  )
}

Przed pierwszą płatnością włącz obsługę Mobilnego SDK w ustawieniach usługi w Panelu SimPay. Zarejestruj też schemat powrotu do aplikacji. Musi odpowiadać wartościom użytym w manifeście Androida i adresach powrotu przekazywanych do SDK.

Arkusz otwierasz z FragmentActivity lub jej podklasy, na przykład AppCompatActivity. Przekazujesz konfigurację usługi, dostawcę sesji i dane zamówienia. Pełny przykład, razem z importami i obsługą powrotu z przeglądarki, jest w instrukcji integracji Android SDK.

Klucz API zostaje na Twoim serwerze

Klucza API akceptanta nie wolno umieszczać w aplikacji. Można go odczytać z APK, nawet jeśli nie występuje w kodzie jako zwykły tekst.

Aplikacja prosi Twój backend o sesję. Backend używa klucza API, aby uzyskać krótko ważny token SimPay, i przekazuje go aplikacji wraz z publicznym adresem IP płatnika. SDK korzysta z tego tokenu do obsługi płatności. Po stronie aplikacji integrację sesji udostępnia interfejs MobileSessionProvider.

To inna rola niż biblioteki Java i Kotlin służące do komunikacji z API. Android SDK dostarcza interfejs płatności w telefonie. Nie zastępuje backendu sklepu.

Wynik w aplikacji to nie zgoda na wydanie towaru

SDK rozróżnia cztery wyniki: płatność potwierdzoną przez API, wynik oczekujący, błąd i zamknięcie arkusza. Wynik oczekujący nie oznacza odrzucenia płatności. Może wymagać dalszej weryfikacji albo pojawić się po upływie czasu odpytywania.

Zamówienie realizuj dopiero po weryfikacji po stronie backendu. Sprawdź podpis notyfikacji IPN, status płatności, identyfikator usługi oraz zgodność transakcji, kwoty, waluty i pola control z zapisanym zamówieniem. Sam powrót z przeglądarki lub callback aplikacji nie jest potwierdzeniem, na którym można oprzeć wysyłkę towaru.

Od czego zacząć?

Otwórz dokumentację Android SDK i sprawdź wymagania integracji. W repozytorium GitHub znajdziesz aplikację demonstracyjną, a w Maven Central opublikowaną paczkę ze źródłami i Javadoc. Biblioteka jest dostępna na licencji MIT.