> For the complete documentation index, see [llms.txt](https://docs.ecommerce.seb.ee/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ecommerce.seb.ee/seb-docs-draft/seb-docs-public-lt/integracija/mobilusis-sdk.md). # Mobilusis SDK Priimkite mokėjimus savo mobiliojoje programėlėje per SEB el. prekybos mokėjimų vartus su minimaliu kodo nustatymu. SDK apdoroja mokėjimo veiksmus, vykstančius įrenginyje: atidaro atsiskaitymo langą, palaiko perėjimą į bankų programėles ir skaitmenines pinigines, palaiko EMV® 3-D Secure, šifruoja kortelės duomenis, kai naudojate natyvią kortelės formą, ir grąžina jūsų programėlei vieną nuoseklų mokėjimo rezultatą. ### Kaip veikia integracija Mobile SDK yra kliento pusės biblioteka, veikianti kartu su jūsų backendu. Jūsų serveris sukuria mokėjimą, o jūsų programėlė gauna reikšmes, kurių reikia mokėjimo srautui pradėti: * `paymentId` - mokėjimo identifikatorius; * `verificationKey` - tikrinimo raktas, gautas iš atsiskaitymo nuorodos; * `checkoutRedirect` - atsiskaitymo nuoroda. Tada jūsų programėlė perduoda šias reikšmes SDK. SDK pateikia mokėjimo sąsają, veda pirkėją per mokėjimo srautą ir per jūsų backendą užklausia galutinį mokėjimo statusą. {% hint style="info" %} Niekada neįterpkite parduotuvės slaptųjų duomenų ar OAuth 2.0 kliento prisijungimo duomenų į mobilioją programėlę. Laikykite ir naudokite juos tik savo backende. {% endhint %} Jūsų backendas taip pat išlieka patikimu mokėjimo būsenos ir užsakymo įvykdymo šaltiniu. Į jūsų programėlę perduodamas rezultatas skirtas parodyti pirkėjui, kas įvyko. Nepatvirtinkite ir nevykdykite užsakymo remdamiesi vien SDK grąžinamu įvykiu: įvykdymą aktyvuokite savo backende pagal platformos pranešimus. ### Galimi mokėjimo srautai Dokumentacijoje aprašyti du būdai priimti mokėjimus. Abu srautai naudoja tą patį mokėjimo objektą, backendo sutartį ir rezultatų modelį. #### Talpinamas atsiskaitymas SDK atveria paruoštą atsiskaitymo puslapį jūsų programėlėje. Naudokite šį srautą, kai norite pasiūlyti visus galimus mokėjimo būdus neapdorodami kortelės duomenų savo vartotojo sąsajoje. Talpinamas atsiskaitymas gali palaikyti mokėjimus kortele, Pay by Bank, Click to Pay, skaitmenines pinigines ir EMV® 3-D Secure. Jūsų programėlė laukia pirkėjo grįžimo per sukonfigūruotą grįžimo URL, tačiau kortelės duomenų negauna. #### Natyvioji kortelės forma Jūs sukuriate kortelės formą savo programėlės vartotojo sąsajoje. SDK įrenginyje šifruoja įvestus duomenis, paleidžia mokėjimo sesiją ir apdoroja 3-D Secure. Naudokite šį srautą, kai mokėjimo forma turi atitikti jūsų programėlės dizainą ir naudotojo patirtį. Kortelės duomenų apsaugos reikalavimai vis tiek galioja: perduokite kortelės duomenis SDK ir nelaikykite jų savo žurnaluose, analitikoje ar kitose programėlės sistemose. ### Ką apima ši dokumentacija Naudokitės žemiau pateiktais skyriais pagal savo integracijos etapą: 1. **Platinimas** - atsisiųskite savo platformai skirtą SDK archyvą ir patikrinkite jo kontrolinę sumą. 2. **iOS SDK / Android SDK** - atidarykite savo platformos dokumentaciją. 3. **Apžvalga** - sužinokite, ką SDK daro, ko nedaro ir ko jam reikia. 4. **Įdiegimas** - pridėkite SDK prie savo projekto. 5. **Greitasis paleidimas** - atlikite pirmąjį mokėjimą Sandbox aplinkoje. 6. **SDK naudojimas** - sukonfigūruokite Talpinamą atsiskaitymą arba natyvią kortelės formą ir apdorokite rezultatą. 7. **Gidai** - sužinokite apie integraciją su backendu, klaidų valdymą ir saugą. 8. **Nuoroda** - raskite konfigūracijos, užklausų, rezultatų ir viešosios API apibrėžtis. ### Aplinkos ir reikalavimai SDK palaiko dvi aplinkas: * **Sandbox** - kūrimui, testavimui ir integracijos patikrai; * **Gamybinė aplinka** - realių mokėjimų apdorojimui. iOS atveju dabartinėje dokumentacijoje nurodyta iOS 15.0 ar naujesnė versija, Xcode 15 ar naujesnė versija, Swift arba Objective-C ir UIKit. SwiftUI pateikiamas tiltas. SDK neturi trečiųjų šalių priklausomybių ir neįtraukia jokių išteklių. SDK archyvai platinami iš šios dokumentacijos svetainės kaip ZIP failai, o ne per viešą paketų saugyklą ar registrą. Patikrinkite archyvą pagal atitinkamą `.sha256` failą prieš diegdami. ### Prieš pradėdami Įsitikinkite, kad turite: * backendą, kuris kuria mokėjimus per SEB E-commerce Payment Gateway; * parduotuvės ir OAuth 2.0 kliento prisijungimo duomenis, sukonfigūruotus jūsų backende; * backendo galinį tašką mokėjimo būsenai tikrinti; * grįžimo URL, kuris grąžina pirkėją į jūsų programėlę; * prieigą prie Sandbox ir bandomųjų mokėjimo duomenų. Pirmąją integraciją pradėkite nuo Talpinamo atsiskaitymo. Jam reikia minimalaus kodo ir jis leidžia greitai patikrinti visą mokėjimo srautą. Po pirmojo sėkmingo mokėjimo Sandbox aplinkoje tęskite su jums reikalingu srautu, tada peržiūrėkite rezultatų apdorojimą, klaidų atkūrimą ir saugos reikalavimus. ### Svarbu: mokėjimo rezultato apdorojimas SDK grąžina vieną iš keturių rezultatų: pavyko, nepavyko, atšauktas arba neapibrėžtas. Neapibrėžtas rezultatas nebūtinai reiškia, kad mokėjimas nepavyko. Pavyzdžiui, mokėjimas vis dar gali būti apdorojamas arba programėlė galėjo prarasti ryšį. Jei mokėjimo būsenos įrenginyje nustatyti nepavyksta, paprašykite savo backendą pateikti dabartinę būseną. Bet kuriuo atveju galutinį sprendimą dėl užsakymo įvykdymo priimkite serveryje. Pradėkite nuo [Platinimas](/seb-docs-draft/seb-docs-public-lt/integracija/mobilusis-sdk/platinimas.md), tada atidarykite savo platformos puslapį ir užbaikite [Greitasis paleidimas](/seb-docs-draft/seb-docs-public-lt/integracija/mobilusis-sdk/ios-sdk/greita-pradzia.md) iOS SDK ir Greitasis paleidimas Android SDK. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.ecommerce.seb.ee/seb-docs-draft/seb-docs-public-lt/integracija/mobilusis-sdk.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.