CA RATY DLA SKLEPÓW INTERNETOWYCH INSTRUKCJA INTEGRACJI Wersja dokumentu: 3.6 Data dokumentu: 26-09-2013 1
Spis treści 1 Definicje... 3 2 Założenia... 3 3 Integracja... 5 3.1 Strona główna sklepu... 5 3.2 Podstrona szczegółów produktu... 8 3.3 Składanie zamówienia przez Klienta sklepu... 13 3.4 Składanie zamówienia przez Klienta sklepu... 14 3.4.1 Składanie zamówienia POST... 14 4 Treści na strony sklepów... 16 4.1 Wariant 1... 16 4.2 Wariant 2... 17 2
1 Definicje Bank Credit Agricole Bank Polska S.A. Partner podmiot prowadzący sklep internetowy, który podpisał umowę z Bankiem na oferowanie sprzedaży ratalnej. ewniosek aplikacja internetowa udostępniona przez Bank, umożliwiająca wykonanie symulacji kredytu ratalnego, złożenie wniosku przez klienta lub w jego imieniu oraz monitowania status złożonego wniosku. identyfikatorsklepu numer identyfikujący Partnera, nadany przez Bank przy podpisywaniu umowy, np. PSP1234567. Oferta zestaw parametrów (oprocentowanie, ilośd rat, ubezpieczenie itd.) na podstawie których zostanie uruchomiony kredyt ratalny. Partner ma dostęp do jednej lub wielu ofert w ramach umowy z Bankiem. Integracja standardowa udostępnienie na stronach sklepu informacji o sprzedaży ratalnej, symulatora kwoty raty oraz przekierowania klienta do ewniosku po złożeniu zamówienia i wyborze płatności ratalnej. Integracja pełna poza integracją standardową sklep może zebrad od klienta wszystkie dane potrzebne do uruchomienia kredytu oraz wysład je do ewniosku w imieniu klienta. Dodatkowo możliwe jest monitorowanie statusu wniosku oraz otrzymywanie powiadomieo w przypadku zmiany statusu. Opis integracji znajduje się w odrębnym dokumencie. 2 Założenia Partner przy podpisaniu umowy otrzymuje m.in. identyfikator sklepu, którym posługuje się w komunikacji z Wnioskiem Na stronach informacyjnych sklepu musi znajdowad się odnośnik do procedury zakupów ratalnych wraz z logotypem CA Raty. Partner jest zobowiązany do umieszczenia informacji o współpracy z Bankiem, w miejscu do tego przeznaczonym na stronie sklepu, najczęściej na podstronie płatności/raty. Treści do umieszczenia są zamieszczone w rozdziale 4 instrukcji. Na stronach z opisem produktu należy umieścid odnośnik do symulatora kredytowego. Zakup ratalny powinien byd dostępny jedynie dla zamówieo, które spełniają warunki umowy pomiędzy Partnerem, a Bankiem. W szczególności kupowany produkt musi należed do dozwolonego asortymentu. Jeżeli towar należy do kategorii niekredytowanej (np. telefony komórkowe) na stronie produktowej symulator nie powinien byd dostępny. Jeżeli taki towar jest w koszyku, płatnośd CA Raty powinna byd zablokowana. Partner powinien przygotowad strony obsługujące powroty klienta z ewniosku. Dotyczy to zarówno powrotu pozytywnego (strona, na którą zostanie przekierowany Klient sklepu po wypełnieniu wniosku ratalnego) jak i negatywnego (strona, na którą zostanie przekierowany Klient sklepu jeśli zrezygnuje z wypełniania wniosku ratalnego). Adresy stron powinny zostad przekazane do Banku. Jako parametr przekazywany jest numer zamówienia przekazany przez Partnera. Strony powrotu powinny zawierad co najmniej następujące informacje: a) Dla powrotu pozytywnego 3 Wniosek został złożony poprawnie dziękujemy. W ciągu 24 h skontaktuje się z Tobą doradca Credit Agricole Bank Polska S.A., potem Twoje zamówienie będzie mogło byd zrealizowane. b) Dla powrotu negatywnego:
Rezygnacja z wypełnienia Wniosku o kredyt ratalny Credit Agricole Bank Polska S.A. Skontaktuj się ze sklepem (lub powrót do.) i wybierz inną metodę płatności. Partner ustala i przekazuje hasło wykorzystywane do komunikacji z Bankiem. Hasło musi mied co najmniej 8 znaków. Niezbędne pliki graficzne prezentujące płatnośd CA Raty są udostępnione Partnerom na serwerach Banku. Pliki (logotyp CA Raty i buttony) muszą zostad podlinkowane z serwerów Banku, banery promocyjne umieszczane są lokalnie na stronach sklepów, ze względu na koniecznośd ich przeskalowania i linkowania do podstron sklepu. Bank zastrzega sobie prawo do modyfikacji elementów graficznych obsługujących CA Raty. W takim przypadku Partner, po otrzymaniu powiadomienia, powinien zmodyfikowad elementy graficzne udostępnione lokalnie. Klient po skompletowaniu zamówienia powinien mied możliwośd wyboru płatności ratalnej. Po jej wyborze mechanizmy sklepu Partnera powinny przesład podstawowe informacje o zamówienia do ewniosku oraz przekierowad przeglądarkę klienta do ewniosku. Jeżeli sklep Partnera nie korzysta z bezpiecznego połączenia SSL (https://) nie powinien przekazywad do Banku danych klienta, jedynie informacje o towarze. Klient powinien wprowadzid swoje dane na stronach ewniosku. Rozwiązanie powinno zostad zaakceptowane przez pracownika Banku przed produkcyjnym uruchomieniem. Dotyczy to zarówno działania mechanizmów (przesyłanie danych) jak i rozwiązao graficznych (np. sposób wykorzystania logotypu CA Raty i ewentualnie logotypu Banku)). 4
3 Integracja 3.1 Strona główna sklepu Strona główna sklepu Partnera musi zawierad logotyp CA Raty (przykład rys. 1). Zaleca się umieszczenie logotypu w głównym layoucie strony, tak aby był on widoczny również na wszystkich podstronach. Logotyp powinien byd widoczny co najmniej w jednym z poniższych miejsc: a) na głównej stronie sklepu (preferowane miejsce jak najbliższej koszyka) b) w miejscu prezentacji innych operatorów płatności: na stronie głównej (zwykle na dole) lub na dedykowanej podstronie płatności/raty Lista dostępnych logotypów: g y.png ue.png https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/485_duckblue.pn https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/485_gray.png https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/485_przezroczyst https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/pion_raty_duckbl https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/pion_raty_gray.p ng 5
czyste.png kblue.png.png zroczyste.png kblue.png.png zroczysty.png kblue.png https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/pion_raty_przezro https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/raty_120x44_duc https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/raty_120x44_gray https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/raty_120x44_prze https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/raty_140x51_duc https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/raty_140x51_gray https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/raty_140x51_prze https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/raty_180x66_duc https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/raty_180x66_gray.png 6
zroczysty.png kblue.png.png zroczysty.png Ważne! Prosimy nie kopiować i nie zapisywać przycisków loklanie. Niedozwolone są jakiekolwiek modyfikacje grafik podlegają one prawom autorskim Banku. Kliknięcie w logotyp CA Raty powinno otwierad procedurę ratalną w nowym oknie: https://ewniosek.credit-agricole.pl/ewniosek/procedure.jsp?param_type=rat¶m_profile =identyfikatorsklepu Przykładowy adres: https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/raty_180x66_prze https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/raty_200x73_duc https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/raty_200x73_gray https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/raty_200x73_prze https://ewniosek.creditagricole.pl/ewniosek/procedure.jsp?param_type=rat¶m_profile=psp1234567 7
Rys. 1. Przykładowa pozycja logotypu CA Raty na stronie głównej sklepu. 3.2 Podstrona szczegółów produktu Na stronach ze szczegółami produktu powinien zostad umieszczony przycisk CA Oblicz ratę (przykład rys. 2). Kliknięcie w przycisk powinno skutkowad otwarciem w nowym oknie/na nowej warstwie symulatora ratalnego z podstawioną ceną produktu. Lista dostępnych przycisków CA Oblicz ratę : https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/raty_485_duckblu e.png https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/raty_485_gray.pn g 8
czysty.png lue.png png oczysty.png Ważne! Prosimy nie kopiować i nie zapisywać przycisków lokalnie. Niedozwolone są jakiekolwiek modyfikacje grafik podlegają one prawom autorskim Banku. Cena produktu powinna zostad przekazana w formacie xxx.xx, bez separatorów tysięcy. https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/raty_485_przezro https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/oblicz_raty_duckb https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/oblicz_raty_gray. https://ewniosek.creditagricole.pl/ewniosek/res/ca_grafika/oblicz_raty_przezr Adres URL otwierający symulator ratalny ma postad: https://ewniosek.creditagricole.pl/ewniosek/simulator.jsp?param_type=rat¶m_profile=identyfikatorsklepu¶m_credi T_AMOUNT=cenaProduktu Przykładowy adres: https://ewniosek.creditagricole.pl/ewniosek/simulator.jsp?param_type=rat¶m_profile=psp1234567¶m_credit_amo UNT=5325.20 9
Rys. 2. Przykładowa pozycja przycisku oblicz ratę na stronie ze szczegółami produktu. Przycisk flash Partner może na swoich stronach umieścid udostępniony przez Bank element aktywny (flash), który wyświetla wyliczoną dynamicznie kwotę raty oraz jest odnośnikiem do symulatora. Ustalenia, dla jakiej oferty oraz jakiego okresu kredytowania, ma byd wyliczana wysokośd raty, Partner powinien przekazad do Banku za pośrednictwem opiekuna handlowego. Flash dostępny jest w następujących wersjach: x28_blue.swf https://ewniosek.creditagricole.pl/ewniosek/resources/swf/rata_dowolna_146 https://ewniosek.creditagricole.pl/ewniosek/resources/swf/rata_dowolna_146 x28_gray.swf 10
x75_blue.swf https://ewniosek.creditagricole.pl/ewniosek/resources/swf/rata_dowolna_370 https://ewniosek.creditagricole.pl/ewniosek/resources/swf/rata_dowolna_370 x75_gray.swf Przykład osadzenia komponentu (przy użyciu skryptu swfobject.js): <script type="text/javascript" src="swfobject.js"></script> <div id="flash"></div> <script type="text/javascript"> var flash = new SWFObject("https://ewniosek.credit-agricole.pl/eWniosek/resources/swf/rata_dowolna_146x28_blue.swf", "", "146", "28", "7", "#ffffff"); flash.addparam("wmode","transparent"); flash.addvariable("rata_url", "https://ewniosek.creditagricole.pl/ewniosek/comm/getinstallment?posid=identyfikatorsklepu%26creditamount=cenaproduktu"); flash.addvariable("click_url", "https://ewniosek.credit-agricole.pl/ewniosek/simulator.jsp?param_profile= identyfikatorsklepu %26PARAM_TYPE=RAT%26PARAM_CREDIT_AMOUNT= cenaproduktu "); flash.write("flash"); </script> W przypadku wykorzystania przycisku flash należy umieścid na stronie poniższą informację prawną. Oferta i okres kredytowania w informacji muszą byd zgodne z ustawieniami przycisku: Szacunkowa wysokość raty kredytu, prezentowana przy cenie towaru, została obliczona dla kredytu ratalnego na zakup towarów i usług oferowanego przez Credit Agricole Bank Polska S.A.. Do prezentacji wysokości raty przyjęta została oferta XXXXXXXXXXXXX oraz XX miesięczny okres kredytowania. Poniższe wyliczenia podane są w oparciu o reprezentatywny przykład w rozumieniu Ustawy o kredycie konsumenckim z 12.05.2011 r. w wyniku czego mogą różnić się od parametrów kredytu dla oferty wybranej przez Kupującego. Dla kredytu na zakup towarów i usług w wysokości XXXX zł (całkowita kwota kredytu), spłacanego w XX miesięcznych równych ratach kapitałowo-odsetkowych (okres obowiązywania umowy XX miesięcy) z oprocentowaniem nominalnym XX % (stopa zmienna), prowizją za udzielenie kredytu w wysokości XXX zł: Rzeczywista Roczna Stopa Oprocentowania wynosi XX,XX %, całkowita kwota do zapłaty wynosi XXXX,XX zł, całkowity koszt kredytu wynosi XXX,XX zł (z czego odsetki wynoszą XXX,XX zł) a kwota raty miesięcznej wynosi XXX,XX zł. Aktualne wyliczenia dla powyższego przykładu reprezentatywnego należy uzyskać od opiekuna handlowego. 11
Animowana procedura Partner może także umieścić na stronie animowaną procedurę, która w atrakcyjnej dla Klienta formie przedstawia proces zakupowy. Przykładowe slajdy animacji: 12
3.3 Składanie zamówienia przez Klienta sklepu W miejscu podsumowania zamówienia, tj. w miejscu gdzie wyświetlona jest lista wszystkich zamówionych produktów wraz z kosztami przesyłki należy umieścid przycisk oblicz ratę, ewentualnie osadzid obiekt flash. Rys. 3. Przykładowa pozycja przycisku CA Oblicz ratę na stronie podsumowania zamówienia. 13
Dopuszczalne jest pokazywanie przycisku CA Oblicz ratę dopiero w momencie wyboru przez Klienta sposobu płatności Credit Agricole Raty. Podobnie jak w przypadku szczegółów produktu (pkt 3.2), kliknięcie w przyciski powinno skutkowad otwarciem w nowym oknie symulatora ratalnego CA Raty. W tym przypadku należy jednak przekazad do symulatora całkowitą wartośd zamówienia łącznie z kosztami przesyłki. Jeżeli na tym etapie niemożliwe jest określenie kosztów przesyłki, to należy przekazad do symulatora jedynie wartośd wszystkich zamówionych produktów. W takim przypadku koszty przesyłki nie będą kredytowane. 3.4 Składanie zamówienia przez Klienta sklepu Po wyborze płatności CA Raty oraz złożeniu zamówienia, skrypt sklepu powinien wysład szczegóły zamówienia do ewniosku. Dane mogą zostad przesłane metodą POST. 3.4.1 Składanie zamówienia POST Dane należy wysład na adres https://ewniosek.credit-agricole.pl/ewniosek/simulator_u.jsp w formularzu POST, używając kodowania UTF8. W przypadku kodowania ISO-8859-2 należy użyd adresu https://ewniosek.creditagricole.pl/ewniosek/simulator.jsp Parametry: Parametr Wartość Opis PARAM_TYPE RAT Typ kredytu, zawsze RAT PARAM_PROFILE Identyfikator sklepu Np. PSP1234567 POST_ATTR 1 Stała cart.shopname nazwa sklepu Opisowa nazwa sklepu creditinfo.creditamount kwotazamowienia W formacie takim jak dla symulacji creditinfo.creditperiod 12 Domyślna liczba rat email.address email klienta cart.ordernumber numerzamowienia Jest przesyłany przy powrocie klienta PARAM_CREDIT_AMOUNT Kwota kredytu W formacie takim jak dla symulacji PARAM_AUTH 1 lub 2 Rodzaj funkcji wyliczania skrótu (1=SHA lub 2=MD5) PARAM_HASH Skrót (hash) Wyliczony skrót według podanego poniżej algorytmu służy do zweryfikowania przesyłanych danych randomizer Losowa wartośd Wchodzi w skład skrótu cart.itemname1 Nazwa towaru 1 Opisowa nazwa towaru 14
cart.itemqty1 Liczba sztuk towaru 1 cart.itemprice1 Cena towaru 1 W formacie takim jak przy symulacji cart.itemnamex cart.itemqtyx cart.itempricex Nazwa towaru X Liczba sztuk towaru X Cena towaru X Dla każdego towaru w zamówienia należy wysład zestaw parametrów Koszty przesyłki, o ile występują, powinny zostad przekazane jako dodatkowy towar o nazwie Przesyłka. Do wyliczenia skrótu PARAM_HASH należy zbudowad ciąg tekstowy z poniższych parametrów, a następnie wyliczyd skrót funkcją md5 lub sha. W przypadku kiedy któryś z parametrów jest pusty, pole pomijamy. Skrót jest wyliczany z następujących wartości Pozycja Nazwa atrybutu Źródło danych 1 Identyfikator sklepu PARAM_PROFILE 2 Typ produktu PARAM_TYPE 3 Rodzaj walidacji PARAM_AUTH 4 Sumaryczna cena towarów creditinfo.creditamount 5 Nazwa pierwszego towaru z koszyka cart.itemname1 6 Cena pierwszego towaru z koszyka cart.itemprice1 7 Wartośd losowa randomizer 8 Hasło sklepu parametryzacja sklepu -> hasło Przykład (dla sklepu PSP1234567, funkcji MD5, kwocie zamówienia 26,07 PLN pierwszym towarze o nazwie Klawiatura PS/2 w cenie 1,07 PLN oraz haśle haslo : PSP1234567RAT226.07Klawiatura PS/21.072012113013484523865haslo Wyliczona wartośd PARAM_HASH to 4018056876d5aa5f75a8d1692ccd2c89 15
4 Treści na strony sklepów 4.1 Wariant 1 /miejsce na umieszczenie logo CA Raty/ Skorzystaj z opcji płatności Credit Agricole Raty i wybieraj to, co najlepsze. Przekonaj się, jakie to proste: przy każdym towarze, który może być kupiony na CA Raty sprawdź wysokość raty gdy kupujesz więcej rzeczy, za całe zakupy zapłacisz w ratach - wygodnie z rat skorzystasz do max. kwoty 20 000 zł samodzielnie dobierzesz ilość rat i ich wysokość, tak by spłata nie była dla Ciebie kłopotliwa szybko i bez zbędnych formalności wypełnisz wniosek, bez wychodzenia z domu umowę i zakupy dostaniesz do domu Sprawdź! /miejsce na umieszczenie animacji CA Raty/ Poniżej zgodnie z z art. 7 ust. 5 ustawy o kredycie konsumenckim Partner - pośrednik zobowiązany jest do podania nazw wszystkich pośredników, z którymi współpracuje. Proponowana treśd: (Nazwa Partnera) oświadcza, iż na podstawie zawartych umów z Credit Agricole Bank Polska S.A. jest upoważniony do wykonywania czynności prawnych związanych z zawarciem/zmianą umów kredytu na zakup towarów i usług. 16
4.2 Wariant 2 Dzięki współpracy z Credit Agricole Bank Polska S.A. możecie Paostwo skorzystad z opcji płatności: Credit Agricole Raty. /miejsce na umieszczenie animacji CA Raty/ CA Raty dostępne: całkowicie online do max. kwoty 20 000 zł za zakupy bez zbędnych formalności spłatę możecie Państwo rozłożyć nawet na 36 miesięcy Ratę można sprawdzid przy wybranym produkcie lub po zakooczonych zakupach w koszyku. Poniżej zgodnie z z art. 7 ust. 5 ustawy o kredycie konsumenckim Partner - pośrednik zobowiązany jest do podania nazw wszystkich pośredników, z którymi współpracuje. Proponowana treśd: (Nazwa Partnera) oświadcza, iż na podstawie zawartych umów z Credit Agricole Bank Polska S.A. jest upoważniony do wykonywania czynności prawnych związanych z zawarciem/zmianą umów kredytu na zakup towarów i usług. 17