> 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-lv/integracija/mobilais-sdk.md). # Mobilais SDK Pieņemiet maksājumus savā mobilajā lietotnē, izmantojot SEB E-komercijas maksājumu vārteju, ar minimālu koda konfigurāciju. SDK apstrādā maksājuma soļus, kas notiek ierīcē: tas atver norēķinu lapu, atbalsta pāradresēšanu uz banku lietotnēm un digitālajiem makiem, atbalsta EMV® 3-D Secure, šifrē kartes datus, ja izmantojat vietējo kartes formu, un atgriež jūsu lietotnei vienu konsekventu maksājuma rezultātu. ### Kā darbojas integrācija Mobilais SDK ir klienta puses bibliotēka, kas darbojas kopā ar jūsu backend. Jūsu serveris izveido maksājumu, un jūsu lietotne saņem vērtības, kas tai nepieciešamas, lai sāktu maksājuma plūsmu: * `paymentId` - maksājuma identifikators; * `verificationKey` - verifikācijas atslēga, kas iegūta no checkout saites; * `checkoutRedirect` - checkout saite. Pēc tam jūsu lietotne nodod šīs vērtības SDK. SDK parāda maksājuma saskarni, vada pircēju cauri maksājuma plūsmai un pieprasa galīgo maksājuma statusu caur jūsu backend. {% hint style="info" %} Nekad neieguliet tirgotāja noslēpumus vai OAuth 2.0 klienta akreditācijas datus mobilajā lietotnē. Uzglabājiet un izmantojiet tos tikai savā backend. {% endhint %} Jūsu backend arī turpmāk ir maksājuma statusa un pasūtījuma izpildes patiesais avots. Rezultāts, kas tiek piegādāts jūsu lietotnei, ir paredzēts, lai parādītu pircējam, kas noticis. Neapstipriniet un neizpildiet pasūtījumu, balstoties tikai uz SDK atpakaļizsaukumu: uzsāciet izpildi savā backend, izmantojot platformas paziņojumus. ### Pieejamās maksājumu plūsmas Dokumentācijā aprakstīti divi veidi, kā pieņemt maksājumus. Abās plūsmās tiek izmantots tas pats maksājums, backend līgums un rezultāta modelis. #### Hostētais Checkout SDK atver gatavo checkout lapu jūsu lietotnē. Izmantojiet šo plūsmu, ja vēlaties piedāvāt visas pieejamās maksājumu metodes, neapstrādājot kartes datus savā lietotāja saskarnē. Hostētais Checkout var atbalstīt karšu maksājumus, Pay by Bank, Click to Pay, digitālos makus un EMV® 3-D Secure. Jūsu lietotne gaida pircēja atgriešanos, izmantojot konfigurēto atgriešanas URL, taču tā nesaņem kartes datus. #### Vietējā kartes forma Jūs izveidojat kartes formu savas lietotnes lietotāja saskarnē. SDK šifrē ierīcē ievadītos datus, uzsāk maksājuma sesiju un apstrādā 3-D Secure. Izmantojiet šo plūsmu, ja maksājuma formai jāatbilst jūsu lietotnes dizainam un lietotāja pieredzei. Joprojām ir spēkā kartes datu aizsardzības prasības: nododiet kartes datus SDK un neglabājiet tos savos žurnālos, analītikā un citās lietotnes sistēmās. ### Ko aptver šī dokumentācija Izmantojiet tālāk norādītās sadaļas atbilstoši savai integrācijas stadijai: 1. **Izplatīšana** - lejupielādējiet savas platformas SDK arhīvu un pārbaudiet tā kontrolsummu. 2. **iOS SDK / Android SDK** - atveriet savas platformas dokumentāciju. 3. **Pārskats** - uzziniet, ko SDK dara, ko tas nedara un kas tam nepieciešams. 4. **Instalēšana** - pievienojiet SDK savam projektam. 5. **Ātrā uzsākšana** - veiciet savu pirmo maksājumu Sandbox vidē. 6. **SDK lietošana** - konfigurējiet Hostēto Checkout vai vietējo kartes formu un apstrādājiet rezultātu. 7. **Ceļveži** - uzziniet par backend integrāciju, kļūdu apstrādi un drošību. 8. **Atsauce** - atrodiet konfigurācijas, pieprasījuma, rezultāta un publiskā API definīcijas. ### Vides un prasības SDK atbalsta divas vides: * **Sandbox** - izstrādei, testēšanai un integrācijas validācijai; * **Ražošana** - reālu maksājumu apstrādei. iOS gadījumā pašreizējā dokumentācija norāda iOS 15.0 vai jaunāku versiju, Xcode 15 vai jaunāku versiju, Swift vai Objective-C un UIKit. SwiftUI ir pieejams tilts. SDK nav trešo pušu atkarību un tajā nav iekļauti resursi. SDK arhīvi no šīs dokumentācijas vietnes tiek izplatīti kā ZIP faili, nevis caur publisku pakotņu repozitoriju vai reģistru. Pārbaudiet arhīvu pret atbilstošo `.sha256` failu pirms instalēšanas. ### Pirms sākat Pārliecinieties, ka jums ir: * backend, kas izveido maksājumus, izmantojot SEB E-commerce Payment Gateway; * tirgotāja un OAuth 2.0 klienta akreditācijas dati, kas konfigurēti jūsu backend; * backend galapunkts maksājuma statusa pārbaudei; * atgriešanas URL, kas atved pircēju atpakaļ uz jūsu lietotni; * piekļuve Sandbox un testa maksājuma datiem. Pirmajai integrācijai sāciet ar Hostēto Checkout. Tam nepieciešams minimāls kods, un tas ļauj ātri pārbaudīt visu maksājumu plūsmu. Pēc pirmā veiksmīgā Sandbox maksājuma turpiniet ar nepieciešamo plūsmu, pēc tam pārskatiet rezultāta apstrādi, kļūmju atkopšanu un drošības prasības. ### Svarīgi: maksājuma rezultāta apstrāde SDK atgriež vienu no četriem rezultātiem: veiksmīgs, neveiksmīgs, atcelts vai neatrisināts. Neatrisināts rezultāts ne vienmēr nozīmē, ka maksājums ir neizdevies. Piemēram, maksājums joprojām var tikt apstrādāts vai lietotne var būt zaudējusi savienojumu. Ja maksājuma statusu ierīcē nevar noteikt, vaicājiet savam backend pašreizējo statusu. Jebkurā gadījumā galīgo lēmumu par pasūtījuma izpildi pieņemiet serverī. Sāciet ar [Izplatīšana](/seb-docs-draft/seb-docs-public-lv/integracija/mobilais-sdk/izplatisana.md), pēc tam atveriet savas platformas lapu un pabeidziet [Ātrā uzsākšana](/seb-docs-draft/seb-docs-public-lv/integracija/mobilais-sdk/ios-sdk/atrais-sakums.md) iOS SDK un Android SDK Quickstart. --- # 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-lv/integracija/mobilais-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.