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