> 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/ios-sdk/ulevaade.md).

# Ülevaade

Tutvuge, mida iOS SDK teeb, mida teie tagasüsteem peab tegema ja mida SDK tööks vajab.

See **iOS-i SDK (EGWPay)** on natiivne Swift'i teek maksete kogumiseks ostjalt teie enda rakenduses.

See katab makseosa, mis peab toimuma seadmes: kassalehe või kaardivormi kuvamine, ostja suunamine läbi EMV® 3-D Secure'i, maksevoo lõppemise tuvastamine, makse oleku lahendamine ning teie rakendusele ühe tulemuse edastamine.

***

## Mida SDK teeb

* Kuvab hostitud kassalehe [`WKWebView-s`](https://developer.apple.com/documentation/webkit/wkwebview) ja jälgib teie tagasipöördumise URL-i.
* Suunab veebivälised navigatsioonid süsteemile, nii et avatud panganduse voog saab üle anda panga oma rakendusele ja sealt tagasi tulla.
* Krüpteerib kaardiandmed seadmes ja juhib kaardisessiooni, kui kasutate oma kaardivormi.
* Kuvab EMV® 3-D Secure'i väljakutse ja salvestab selle tulemuse.
* Lahendab lõpliku makseoleku ja edastab teie rakendusele täpselt ühe tulemuse.

## Mida SDK ei tee

**SDK ei algata makseid.** Makse algatamine autentib end OAuth 2.0 klientmandaatidega, kasutades teie poe kliendisaladust, ning seda saladust ei tohi kunagi rakendusse lisada: igaüks, kellel see on, saab teie poe nimel makseid luua. Makse algatamine kuulub teie taustsüsteemi.

{% hint style="info" %}
SDK on kliendipoolne teek. Teie taustsüsteem loob makse ja jääb autoriteediks selle üle, kas see lõpetati edukalt. Vt [Taustsüsteemi integreerimine](/seb-docs-draft/seb-docs-public-et/integratsioon/mobiilne-sdk/ios-sdk/juhendid/tagasusteemi-integratsioon.md).
{% endhint %}

***

## Teie vastutused

SDK haldab makse seadmesisest osa. Teie rakendus jääb vastutavaks järgmiste eest:

* Makse algatamine teie taustsüsteemist ja saadud väärtuste edastamine rakendusele.
* Teie kliendimandaatide kaitsmine.
* Tagasipöördumise URL-i registreerimine, mille kaudu teie rakendusse tagasi jõutakse.
* Tellimuse elutsükli haldamine ja tellimuste täitmine teie taustsüsteemist, mitte rakendusest.

{% hint style="danger" %}
**Kohtle SDK tulemust kasutajakogemuse signaalina, mitte kunagi kui volitust tellimuse täitmiseks.** Seade võib kaotada ühenduse pärast makse sooritamist, kuid enne kui teie rakendus sellest teada saab, mistõttu võib tasunud ostja ekraanil siiski näha tõrget. Siduge täitmine teavitustega, mida platvorm teie taustsüsteemile saadab.
{% endhint %}

## Sisenemispunktid

| Sisenemispunkt      | Meetod                                      | Kasutage, kui                                                                                              |
| ------------------- | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| Hostitud kassa      | `startPayment(_:from:completion:)`          | Soovite kõiki makseviise, mida platvorm pakub, ilma et kaardiandmed oleksid teie rakenduses.               |
| Natiivne kaardivorm | `startCardPayment(_:card:from:completion:)` | Soovite, et kaardiandmed kogutaks teie enda kasutajaliideses, kujundatuna teie enda disainisüsteemi järgi. |

Mõlemad sisenemispunktid töötavad sama maksega. Eraldi kaardi algatamist ei ole, seega rakendus, mis pakub mõlemat, teeb ühe taustsüsteemi kõne ja laseb ostjal valida.

***

## Nõuded

| Nõue                      | Väärtus                                             |
| ------------------------- | --------------------------------------------------- |
| Platvorm                  | iOS 15.0 või uuem                                   |
| Keel                      | Swift, kutsutav ka Objective-C-st                   |
| Kasutajaliidese raamistik | UIKit koos sillaga SwiftUI jaoks                    |
| Tööriistakett             | Xcode 15 või uuem                                   |
| Sõltuvused                | Puuduvad                                            |
| Pakendatud ressursid      | Puuduvad. Kogu SDK kasutajaliides on loodud koodis. |

Avalik API on täielikult Objective-C-ga ühilduv, seega on Objective-C rakendused toetatud ilma sillakihita. Vt [Objective-C ja SwiftUI](/seb-docs-draft/seb-docs-public-et/integratsioon/mobiilne-sdk/ios-sdk/sdk-kasutamine/objective-c-ja-swiftui.md).

***

## Keskkonnad

SDK toetab nii Sandboxi kui ka Productioni.

| Keskkond   | Eesmärk                                            |
| ---------- | -------------------------------------------------- |
| Sandbox    | Arendus, testimine ja integratsiooni valideerimine |
| Production | Reaalajas maksete töötlemine                       |

Keskkonna valimine toimub sobivate baas-URL-ide seadistamisega.  `keskkonna` omadus `suvandis` Configuration on informatiivne: see ei muuda ühtegi URL-i ning on olemas selleks, et teie enda kood ja logid saaksid üht keskkonda teisest eristada.

***

## Versioonihaldus ja tugi

SDK järgib **MAJOR.MINOR.PATCH** versioonimist ja on praegu enne 1.0 versiooni, mis tähendab, et **väike** väljalase võib API-d muuta.

Kinnitage täpne versioon või lubage kuni järgmise väikeversioonini. Ärge lubage kuni järgmise põhiversioonini.

***

## Jaotus

SDK tarnitakse kontrollsummaga kinnitatud ZIP-arhiivina, mitte pakiregistri väljalaskena. Kontrollige arhiivi, pakkige see lahti ja viidake sellele oma projektis Swift Package Manageri, CocoaPodsi või eelkoostatud XCFrameworki kaudu. Vt [Installimine](/seb-docs-draft/seb-docs-public-et/integratsioon/mobiilne-sdk/ios-sdk/installimine.md).


---

# 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/ios-sdk/ulevaade.md?ask=<question>&goal=<user_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.