Zaktualizowanie 20 maja 2021 r. 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 niezwłocznie nanieś ewentualną niezbędną zmianę. 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.
   
   

   Moduły sklepowe to: Woocommerce, Prestashop, Magento, WP e-Commerce, OpenCart, Quick.Cart, Drupal + Commerce, Easy Digital Downloads, WHMCS, VirtueMart, Quick.Cart, Blesta, cs.cart, BoxBilling, Joomshopping, osCommerce.

   Ich aktualne wersje znajdziesz tutaj: https://tpay.com/dla-developera/integracje. 

   
   
2. Jeśli integrujesz się z systemem płatności Tpay poprzez tzw. moduły preinstalowane w sklepach, Twój dostawca powinien nanieść odpowiednie zmiany. Jeśli jeszcze tego nie zrobił - pilnie skontaktuj się z nim.
   
   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)).