Zaktualizowanie 20 maja 2021 r. przez Tpay sposobu liczenia sumy kontrolnej zawartej w polu md5sum w przypadku niektórych sposobów integracji z systemem może oznaczać konieczność naniesienia zmian w kodzie systemu. 

 

Znajdź w poniższych wskazówkach swój sposób integracji i jak najszybciej nanieś ewentualną niezbędną zmianę (masz czas do 20 lipca 2021 r.). Dzięki temu nadal będziemy mogli świadczyć dla Ciebie usługi płatnicze.

 

  1. Jeśli integrujesz się z systemem płatności Tpay poprzez moduły sklepowe dostarczane przez Tpay, upewnij się tylko, że masz aktualną wersję wtyczki. Aktualizacja dokonywana przez nas wystarczy, abyś nadal mógł(a) przyjmować płatności.
  2. Jeśli integrujesz się z systemem płatności Tpay poprzez tzw. moduły preinstalowane w sklepach, Twój dostawca musi nanieść odpowiednie zmiany. Czy zatem powinieneś teraz skontaktować się ze swoim dostawcą? Nie, nie musisz - poinformowaliśmy już go o tym i wskazaliśmy, co musi zmienić.

    Moduły preinstalowane w sklepach to: IAI, Automater, Ebexo, ePRO, RedCart, SklepyFirmowe, Gekosale, 100sklepow, Selly, 24-sklep, Max-Shop, shopGold, Shoplo, sklep-szybko, KQS-Project, GOcreate, Shop-it, I-sklep, Goshop, Intralogic, Marpnet, Iwebstore, Shoppy, SklepNa5, Aptusshop.pl, Sellingo, Sellasist, AtomStore, cStore, Sellsmart, Ruby Gem, Sky-Shop, Sleekstore na WordPress, Sotech, Odoo, BestSeller.
  3. Jeśli integrujesz się z systemem Tpay z wykorzystaniem API opisanym w dokumentacji, musisz dokonać zmian w funkcji, która finalnie przekazuje wartość do parametru md5sum w metodzie create.



    Dokonaj zmiany w generowaniu sumy kontrolnej, która później przekazywana jest do utworzenia transakcji z md5($ID.$amount.$crc.$securityCode) na md5($ID.’&’.$amount.’&’.$crc.’&’.$securityCode);

    - polega ona na dodaniu separatora w postaci znaku & (ampersand) pomiędzy polami potrzebnymi do wyliczenia sumy kontrolnej.

  4. Jeśli do integracji z systemem Tpaywykorzystujesz Biblioteki Tpay, jedynie dokonaj aktualizacji bibliotek (zachowana będzie pełna kompatybilność wsteczna).
  5. Jeśli integrujesz się z systemem płatności Tpay poprzez openAPI i korzystasz z dedykowanego API kartowego na docs.tpay.com, musisz dokonać zmiany w parametrze sign dla każdej metody z api kartowego.

    Na przykład w przypadku Secure Sale:

     

    ( z hash_alg (method + card + name + email + desc + amount + currency + order_id + onetimer + language + enable_pow_url + verification code) na hash_alg (method +'&'+ card +'&'+ name +'&'+ email +'&'+ desc +'&'+ amount +'&'+ currency +'&'+ order_id +'&'+ onetimer +'&'+ language +'&'+ enable_pow_url +'&'+ verification code))

  6. Jeśli integrujesz się z systemem płatności Tpay poprzez API kartowe, musisz zmienić mechanikę generowania parametru przekazywanego finalnie jako sign w każdej metodzie płatności.

    Na przykład w przypadku Secure Sale:

     

    ( z hash_alg (method + card + name + email + desc + amount + currency + order_id + onetimer + language + enable_pow_url + verification code) na hash_alg (method +'&'+ card +'&'+ name +'&'+ email +'&'+ desc +'&'+ amount +'&'+ currency +'&'+ order_id +'&'+ onetimer +'&'+ language +'&'+ enable_pow_url +'&'+ verification code)).