> 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-et/integratsioon/mobiilne-sdk.md). # Mobiilne SDK Võtke makseid vastu oma mobiilirakenduses SEB e-kaubanduse makselüüsi kaudu minimaalse koodiseadistusega. SDK käsitleb makseetappe, mis toimuvad seadmes: see avab kassalehe, toetab suunamist pangarakendustesse ja digirahakottidesse, toetab EMV® 3-D Secure’i, krüpteerib kaardiandmed, kui kasutate natiivset kaardivormi, ning tagastab teie rakendusele ühe ühtse maksetulemuse. ### Kuidas integratsioon töötab Mobile SDK on kliendipoolne teek, mis töötab koos teie taustsüsteemiga. Teie server loob makse ning teie rakendus saab väärtused, mida ta vajab maksevoo käivitamiseks: * `paymentId` - makse identifikaator; * `verificationKey` - kontrollvõti, mis on saadud kassalingilt; * `checkoutRedirect` - kassalink. Seejärel edastab teie rakendus need väärtused SDK-le. SDK kuvab makseliidese, juhendab ostjat maksevoolu kaudu ning küsib lõplikku makseolekut teie taustsüsteemi kaudu. {% hint style="info" %} Ärge kunagi manustage mobiilirakendusse poe saladusi ega OAuth 2.0 kliendimandaate. Hoidke ja kasutage neid ainult oma taustsüsteemis. {% endhint %} Teie taustsüsteem jääb samuti makseoleku ja tellimuse täitmise tõeallikaks. Teie rakendusele edastatud tulemus on mõeldud ostjale näitamaks, mis juhtus. Ärge kinnitage ega täitke tellimust ainult SDK tagasikutse alusel: käivitage täitmine oma taustsüsteemis platvormi teavituste põhjal. ### Saadaolevad maksevoolud Dokumentatsioon kirjeldab kahte viisi maksete vastuvõtmiseks. Mõlemad vood kasutavad sama makset, taustsüsteemi lepingut ja tulemuse mudelit. #### Hostitud kassaleht SDK avab teie rakenduses valmis kassalehe. Kasutage seda voogu, kui soovite pakkuda kõiki saadaolevaid makseviise ilma kaardiandmeid oma kasutajaliideses käsitlemata. Hostitud kassaleht toetab kaardimakseid, maksmist pangalingiga, Click to Pay’d, digirahakotte ja EMV® 3-D Secure’i. Teie rakendus ootab ostja naasmist konfigureeritud tagasipöördumise URL-i kaudu, kuid kaardiandmeid ei saa ta. #### Natiivne kaardivorm Teie koostate kaardivormi oma rakenduse kasutajaliideses. SDK krüpteerib sisestatud andmed seadmes, alustab maksesessiooni ja käsitleb 3-D Secure’i. Kasutage seda voogu, kui maksevorm peab vastama teie rakenduse disainile ja kasutuskogemusele. Kaardiandmete kaitse nõuded kehtivad endiselt: edastage kaardiandmed SDK-le ning hoidke need eemal oma logidest, analüütikast ja muudest rakenduse süsteemidest. ### Mida see dokumentatsioon hõlmab Kasutage allolevaid jaotisi vastavalt oma integratsioonietapile: 1. **Jaotus** - laadige alla oma platvormi SDK arhiiv ja kontrollige selle kontrollsummat. 2. **iOS SDK / Android SDK** - avage oma platvormi dokumentatsioon. 3. **Ülevaade** - tutvuge sellega, mida SDK teeb, mida see ei tee ja mida see nõuab. 4. **Paigaldamine** - lisage SDK oma projekti. 5. **Kiirkäivitamine** - tehke oma esimene makse Sandboxis. 6. **SDK kasutamine** - seadistage Hostitud kassaleht või natiivne kaardivorm ja käsitlege tulemust. 7. **Juhendid** - tutvuge taustsüsteemi integratsiooni, veakäitluse ja turvalisusega. 8. **Viide** - leidke konfiguratsiooni, päringu, tulemuse ja avaliku API definitsioonid. ### Keskkonnad ja nõuded SDK toetab kahte keskkonda: * **Sandbox** - arenduseks, testimiseks ja integratsiooni valideerimiseks; * **Tootmine** - reaalsete maksete töötlemiseks. iOS-i puhul määrab käesolev dokumentatsioon praegu nõueteks iOS 15.0 või uuem, Xcode 15 või uuem, Swift või Objective-C ning UIKit. SwiftUI jaoks on olemas sild. SDK-l puuduvad kolmanda osapoole sõltuvused ja see ei sisalda ühtegi ressurssi. SDK arhiivid levitatakse sellest dokumentatsioonisaidist ZIP-failidena, mitte avaliku pakettide hoidla või registri kaudu. Kontrollige arhiivi vastava `.sha256` failiga enne selle paigaldamist. ### Enne alustamist Veenduge, et teil on: * taustsüsteem, mis loob makseid SEB E-commerce Payment Gateway kaudu; * poe- ja OAuth 2.0 kliendimandaadid, mis on teie taustsüsteemis seadistatud; * taustsüsteemi lõpp-punkt makseoleku kontrollimiseks; * tagasipöördumise URL, mis viib ostja tagasi teie rakendusse; * juurdepääs Sandboxile ja testmakse andmed. Oma esimeseks integratsiooniks alustage Hostitud kassalehega. See nõuab minimaalset koodi ja võimaldab teil kiiresti kontrollida tervet maksevoolu. Pärast oma esimest õnnestunud Sandboxi makset jätkake teile vajaliku vooga ning seejärel vaadake üle tulemuse käsitlemine, tõrkest taastumine ja turvanõuded. ### Oluline: maksetulemuse käsitlemine SDK tagastab ühe neljast tulemusest: õnnestunud, ebaõnnestunud, tühistatud või määramata. Määramata tulemus ei tähenda tingimata, et makse ebaõnnestus. Näiteks võib makse olla veel töötlemisel või rakendus võis ühenduse kaotada. Kui makseolekut ei saa seadmes kindlaks teha, küsige oma taustsüsteemilt praegust olekut. Igal juhul tehke tellimuse täitmise kohta lõplik otsus serveris. Alustage [Jaotus](/seb-docs-draft/seb-docs-public-et/integratsioon/mobiilne-sdk/jaotus.md), seejärel avage oma platvormi leht ja viige lõpule [Kiirkäivitamine](/seb-docs-draft/seb-docs-public-et/integratsioon/mobiilne-sdk/ios-sdk/kiirstart.md) iOS SDK ja Android SDK kiirkäivituse jaoks. --- # 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-et/integratsioon/mobiilne-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.