Jak wygenerować dostęp do API kart płatniczych

Ostatnia aktualizacja: 21.11.2024

W celu skorzystania z bramki kartowej strona sklepu powinna posiadać ważny certyfikat SSL lub TLS. Do wygenerowania dostępu do API kartowego należy mieć ważną umowę z firmą Elavon oraz przydzielony MID.

Następnie należy skontaktować się z Biurem Obsługi Klienta Tpay, aby aktywować dostęp do API kartowego.

  1. Zaloguj się do Panelu Akceptanta Tpay i wybierz z menu Płatności kartami -> API
  2. Naciśnij przycisk Generuj w celu wygenerowania Kodu Weryfikacyjnego:

     
  3. Następnie wprowadź nowe hasło API oraz zaznacz opcję Użyj metody securesale. Po zapisaniu danych, Twój klucz publiczny pojawi się w tym samym oknie.
  4. W polu Adres URL powiadomień wpisz link, na który nasz serwis będzie przesyłać informacje o opłaconych transakcjach, celem aktualizacji ich statusu w sklepie. Na przykład: https://adressklepu.pl/tpay/confirmation
  5. Adresy powrotne są opcjonalne w przypadku gotowych modułów sklepowych, gdyż moduł płatności przesyła je automatycznie dla każdej transakcji. W tym miejscu można wprowadzić na przykład:
    https://adressklepu.pl/tpay/order-success
    oraz:
    https://adressklepu.pl/tpay/order-error
    Tworząc własną integrację, można zadeklarować statyczne adresy stron z podziękowaniem i błędem lub przesyłać je dynamicznie tworząc każdą transakcję. W momencie ich przesłania, parametry wprowadzone w te ustawienia zostaną nadpisane dla danej transakcji.
  6. Z listy rozwijanej wybierz algorytm podpisu, który będzie wykorzystywany do tworzenia sumy kontrolnej potwierdzającej integralność przesyłanych informacji. Domyślny algorytm to sha1. Pamiętaj, aby następnie w module sklepowym lub własnym skrypcie wybrać taki sam algorytm.
  7. Naciśnij przycisk Zapisz, aby zatwierdzić wygenerowany dostęp.

W pierwszej kolejności nasz dział techniczny aktywuje dostęp w trybie testowym. Po przeprowadzeniu testów prosimy o ponowny kontakt w celu aktywacji trybu produkcyjnego.

Jeśli nie masz jeszcze konta sprzedawcy lub dostępu do kart płatniczych i chcesz przetestować integrację, skorzystaj z danych konta demo:

  • Klucz API: bda5eda723bf1ae71a82e90a249803d3f852248d
  • Hasło API: IhZVgraNcZoWPLgA1yQcGMIzquVWWrWtJ
  • Kod weryfikacyjny: 6680181602d396e640cb091ea5418171
  • Metoda hash'owania podpisu: sha512
  • Klucz publiczny RSA:  LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0NCk1JR2ZNQTBHQ1NxR1NJYjNEUUVCQVFVQUE0R05BRENCaVFLQmdRQ2NLRTVZNU1Wemd5a1Z5ODNMS1NTTFlEMEVrU2xadTRVZm1STS8NCmM5L0NtMENuVDM2ekU0L2dMRzBSYzQwODRHNmIzU3l5NVpvZ1kwQXFOVU5vUEptUUZGVyswdXJacU8yNFRCQkxCcU10TTVYSllDaVQNCmVpNkx3RUIyNnpPOFZocW9SK0tiRS92K1l1YlFhNGQ0cWtHU0IzeHBhSUJncllrT2o0aFJDOXk0WXdJREFRQUINCi0tLS0tRU5EIFBVQkxJQyBLRVktLS0tLQ

 

Dane są dostępne na koncie demo, możesz je zweryfikować logując się w Panelu Akceptanta danymi:

  • ID Sprzedawcy: 1010
  • Hasło: demo