{"id":10321,"date":"2023-06-14T09:49:56","date_gmt":"2023-06-14T09:49:56","guid":{"rendered":"https:\/\/www.qly.docs.pay.sibs.com\/szczegoly-karty-sklepu\/"},"modified":"2026-03-09T16:40:12","modified_gmt":"2026-03-09T16:40:12","slug":"zapisanie-danych-karty","status":"publish","type":"page","link":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/sibs-gateway-dokumentacja\/funkcjonalnosci-platnosci-online\/karta-oneclick\/zapisanie-danych-karty\/","title":{"rendered":"Zapisanie danych karty"},"content":{"rendered":"\n\n\n

Gdy sprzedawca proponuje zalogowanemu posiadaczowi karty utworzenie p\u0142atno\u015bci jednym klikni\u0119ciem, prezentowane s\u0105 obowi\u0105zuj\u0105ce warunki.<\/p>\n\n\n\n

Je\u015bli posiadacz karty zaakceptuje i poda dane swojej karty, musi przeprowadzi\u0107 silne uwierzytelnienie klienta 3D Secure zgodnie z wymogami. Po pomy\u015blnym uwierzytelnieniu karta jest tokenizowana i rejestrowana w Mi\u0119dzynarodowym Systemie P\u0142atno\u015bci (IPS). Token jest nast\u0119pnie dostarczany do sprzedawcy i rejestrowany jako karta w pliku.<\/p>\n\n\n\n

Jak to dzia\u0142a<\/h3>\n\n\n\n

Aby wykona\u0107 p\u0142atno\u015b\u0107 z autoryzacj\u0105 3DS, najpierw utw\u00f3rz zam\u00f3wienie<\/a> zgodnie z instrukcjami zawartymi w Przewodniku integracji<\/a> API (FULL CODE).<\/p>\n\n\n\n

Nale\u017cy pami\u0119ta\u0107, \u017ce do \u017c\u0105dania zam\u00f3wienia nale\u017cy do\u0142\u0105czy\u0107 dodatkowe parametry OneClick<\/mark> i Tokenization<\/mark>, jak pokazano poni\u017cej: <\/p>\n\n\n\n

Lokalizacja<\/strong><\/td>Element danych<\/strong><\/td>Typ<\/strong><\/td>Stan<\/strong><\/td>Opis<\/strong><\/td><\/tr>
Tre\u015b\u0107 \u017c\u0105dania.transakcja<\/td>oneClick<\/mark><\/td>OneClick<\/td>Obowi\u0105zkowe<\/td>Obiekt definiuj\u0105cy p\u0142atno\u015b\u0107 jednym klikni\u0119ciem. Wyst\u0119puje tylko w przypadku sprzedawc\u00f3w korzystaj\u0105cych z One Click Payment.<\/td><\/tr>
Request Body.transaction.oneClick<\/td>customerAcceptance<\/mark><\/td>logiczna<\/td>Obowi\u0105zkowe<\/td>Wskazuje, czy Klient zaakceptowa\u0142 Regulamin us\u0142ugi One Click Payment w celu kontynuowania p\u0142atno\u015bci.
Ma warto\u015b\u0107 „True<\/mark>„, je\u015bli Warunki p\u0142atno\u015bci jednym klikni\u0119ciem zosta\u0142y przedstawione przez Sprzedawc\u0119 i wyra\u017anie zaakceptowane przez Klienta. W przeciwnym razie musi mie\u0107 warto\u015b\u0107 „False<\/mark>„. W przypadku braku nale\u017cy przyj\u0105\u0107 warto\u015b\u0107 „False”.<\/td><\/tr>
Tre\u015b\u0107 \u017c\u0105dania<\/td>tokenizacja<\/mark><\/td>Tokenizacja<\/td>Obowi\u0105zkowe<\/td>Tokeny p\u0142atno\u015bci klienta. Tokeny te s\u0105 dostarczane na koniec udanej tokenizacji. Obecne tylko do cel\u00f3w tokenizacji.<\/td><\/tr>
Request Body.tokenisation<\/td>tokenisationRequest<\/mark><\/td>TokenisationRequest<\/td>Obowi\u0105zkowe<\/td>Podane pole w \u017c\u0105daniu realizacji transakcji w celu wykonania tokenizacji karty. <\/td><\/tr>
Request Body.tokenisation.tokenisationRequest<\/td>tokeniseCard<\/mark><\/td>logiczna<\/td>Obowi\u0105zkowe<\/td>Wskazuje, czy wymagana jest tokenizacja karty.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Przyk\u0142ad \u017c\u0105dania:<\/strong><\/p>\n\n\n\n

\n
Uruchom w Postmanie<\/a><\/div>\n<\/div>\n\n\n\n
\t{\n\t    \"merchant\"<\/mark>: {\n\t        \"terminalId\"<\/mark>: {{TerminalID}}<\/mark>,\n\t        \"channel\"<\/mark>: \"web\"<\/mark>,\n\t        \"merchantTransactionId\"<\/mark>: \"Order Id: r7cxvi0saj\"<\/mark>\n\t    },\n\t    \"transaction\"<\/mark>: {\n\t        \"transactionTimestamp\"<\/mark>: \"{{trxDatetime}}\"<\/mark>,\n\t        \"description\"<\/mark>: \"Transaction for order number 4908 terminalId 100886\"<\/mark>,\n\t        \"moto\"<\/mark>: false<\/mark>,\n\t        \"paymentType\"<\/mark>: \"PURS\"<\/mark>,\n\t        \"amount\"<\/mark>: {\n\t            \"value\"<\/mark>: 50.50<\/mark>,\n\t            \"currency\"<\/mark>: \"PLN\"<\/mark>\n\t        },\n\t        \"paymentMethod\"<\/mark>: [\n\t            \"CARD\"<\/mark>\n\t        ],\n\t        \"oneClick\"<\/mark>: {\n\t            \"customerAcceptance\"<\/mark>: true<\/mark>\n\t        }\n\t    },\n\t    \"tokenisation\"<\/mark>: {\n\t        \"tokenisationRequest\"<\/mark>: {\n\t            \"tokeniseCard\"<\/mark>: true<\/mark>\n\t        }\n\t    }\n\t}<\/code><\/pre>\n\n\n\n
Do \u017c\u0105dania zakupu nale\u017cy do\u0142\u0105czy\u0107 dodatkowe parametry DeviceInfo<\/mark> i OneClick<\/mark>, jak pokazano poni\u017cej.<\/p>\n\n\n\n
Lokalizacja<\/strong><\/td>Element danych<\/strong><\/td>Typ<\/strong><\/td>Stan<\/strong><\/td>Opis<\/strong><\/td><\/tr>
Request Body.info<\/td>deviceInfo<\/mark><\/td>DeviceInfo<\/td>Obowi\u0105zkowe<\/td>Obiekt definiuj\u0105cy informacje o urz\u0105dzeniu klienta.<\/td><\/tr>
Request Body.info.deviceInfo<\/td>browserAcceptHeader<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>Nag\u0142\u00f3wek akceptacji przegl\u0105darki.<\/td><\/tr>
Request Body.info.deviceInfo<\/td>browserJavaEnabled<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>Przegl\u0105darka z w\u0142\u0105czon\u0105 obs\u0142ug\u0105 Java<\/td><\/tr>
Request Body.info.deviceInfo<\/td>browserJavascriptEnabled<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>W\u0142\u0105czona obs\u0142uga Javascript w przegl\u0105darce<\/td><\/tr>
Request Body.info.deviceInfo<\/td>browserLanguage<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>J\u0119zyk przegl\u0105darki.<\/td><\/tr>
Request Body.info.deviceInfo<\/td>browserColorDepth<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>G\u0142\u0119bia kolor\u00f3w przegl\u0105darki.<\/td><\/tr>
Request Body.info.deviceInfo<\/td>browserScreenHeight<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>Wysoko\u015b\u0107 ekranu przegl\u0105darki.<\/td><\/tr>
Request Body.info.deviceInfo<\/td>browserScreenWidth<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>Szeroko\u015b\u0107 ekranu przegl\u0105darki.<\/td><\/tr>
Request Body.info.deviceInfo<\/td>browserTZ<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>Strefa czasowa przegl\u0105darki.<\/td><\/tr>
Request Body.info.deviceInfo<\/td>browserUserAgent<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>Agent u\u017cytkownika przegl\u0105darki.<\/td><\/tr>
Request Body.info.deviceInfo<\/td>systemFamily<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>Rodzina system\u00f3w.<\/td><\/tr>
Request Body.info.deviceInfo<\/td>systemVersion<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>Wesja systemu.<\/td><\/tr>
Request Body.info.deviceInfo<\/td>systemArchitecture<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>Architektura systemu.<\/td><\/tr>
Request Body.info.deviceInfo<\/td>deviceManufacturer<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>Producent urz\u0105dzenia.<\/td><\/tr>
Request Body.info.deviceInfo<\/td>deviceModel<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>Model urz\u0105dzenia.<\/td><\/tr>
Request Body.info.deviceInfo<\/td>deviceID<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>Unikalny identyfikator urz\u0105dzenia<\/td><\/tr>
Request Body.info.deviceInfo<\/td>applicationName<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>Nazwa aplikacji.<\/td><\/tr>
Request Body.info.deviceInfo<\/td>applicationVersion<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>Wersja aplikacji.<\/td><\/tr>
Request Body.info.deviceInfo<\/td>geoLocalization<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>Geolokalizacja.<\/td><\/tr>
Request Body.info.deviceInfo<\/td>ipAddress<\/mark><\/td>Ci\u0105g<\/td>Opcionalnie<\/td>Adres IP.<\/td><\/tr>
Tre\u015b\u0107 \u017c\u0105dania<\/td>oneClick<\/mark><\/td>OneClick<\/td>Obowi\u0105zkowe<\/td>Obiekt definiuj\u0105cy p\u0142atno\u015b\u0107 jednym klikni\u0119ciem.<\/td><\/tr>
Request Body.oneClick<\/td>oneClickCreation<\/mark><\/td>logiczna<\/td>Obowi\u0105zkowe<\/td>Obiekt definiuj\u0105cy p\u0142atno\u015b\u0107 jednym klikni\u0119ciem. Wskazuje, czy klient \u017c\u0105da utworzenia p\u0142atno\u015bci jednym klikni\u0119ciem. Brak wskazuje warto\u015b\u0107 „False<\/mark>„.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Przyk\u0142ad \u017c\u0105dania:<\/strong><\/p>\n\n\n\n
\n
Uruchom w Postmanie<\/a><\/div>\n<\/div>\n\n\n\n
\t{\n\t    \"info\"<\/mark>: {\n\t        \"deviceInfo\"<\/mark>: {\n\t            \"browserAcceptHeader\"<\/mark>: \"application\/json, text\/plain, *\/*\"<\/mark>,\n\t            \"browserJavaEnabled\"<\/mark>: \"false\"<\/mark>,\n\t            \"browserLanguage\"<\/mark>: \"en\"<\/mark>,\n\t            \"browserColorDepth\"<\/mark>: \"24\"<\/mark>,\n\t            \"browserScreenHeight\"<\/mark>: \"1080\"<\/mark>,\n\t            \"browserScreenWidth\"<\/mark>: \"1920\"<\/mark>,\n\t            \"browserTZ\"<\/mark>: \"-60\"<\/mark>,\n\t            \"browserUserAgent\"<\/mark>: \"Mozilla\/5.0 (Windows NT 10.0; WOW64) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/106.0.0.0 Safari\/537.36\"<\/mark>,\n\t            \"geoLocalization\"<\/mark>: \"Lat: 38.7350528 | Long: -9.2143616\"<\/mark>,\n\t            \"systemFamily\"<\/mark>: \"Windows\"<\/mark>,\n\t            \"systemVersion\"<\/mark>: \"Windows\"<\/mark>,\n\t            \"deviceID\"<\/mark>: \"498bfd4c3a3645b38667a7037b616c18\"<\/mark>,\n\t            \"applicationName\"<\/mark>: \"Chrome\"<\/mark>,\n\t            \"applicationVersion\"<\/mark>: \"106\"<\/mark>\n\t        },\n\t        \"customerInfo\"<\/mark>: [\n\t            {\n\t                \"key\"<\/mark>: \"customerName\"<\/mark>,\n\t                \"value\"<\/mark>: \"User X\"<\/mark>\n\t            },\n\t            {\n\t                \"key\"<\/mark>: \"customerEmail\"<\/mark>,\n\t                \"value\"<\/mark>: \"testingemail@gmail.com\"<\/mark>\n\t            }\n\t        ]\n\t    },\n\t    \"cardInfo\"<\/mark>: {\n\t        \"PAN\"<\/mark>: \"{{MC3DSCardNum}}\"<\/mark>,\n\t        \"secureCode\"<\/mark>: \"{{MC3DSCardCVV}}\"<\/mark>,\n\t        \"validationDate\"<\/mark>: \"{{MC3DSCardExpiry}}\"<\/mark>,\n\t        \"cardholderName\"<\/mark>: \"TKN {{trxDatetime}}\"<\/mark>,\n\t        \"createToken\"<\/mark>: true<\/mark>\n\t    },\n\t    \"oneClick\"<\/mark>: {\n\t        \"oneClickCreation\"<\/mark>: true<\/mark>\n\t    }\n\t}\n<\/code><\/pre>\n\n\n\n
Nast\u0119pnie mo\u017cesz przyst\u0105pi\u0107 do dokonania p\u0142atno\u015bci<\/a>.<\/p>\n\n\n\n