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.
- 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.
- 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.
- 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.
- Jeśli do integracji z systemem Tpaywykorzystujesz Biblioteki Tpay, jedynie dokonaj aktualizacji bibliotek (zachowana będzie pełna kompatybilność wsteczna).
- 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))
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)).
