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

# Apžvalga

Sužinokite, ką daro iOS SDK, ką turi atlikti jūsų galinė sistema ir ko reikia SDK veikimui.

Šis **iOS SDK (EGWPay)** yra natyvinė „Swift“ biblioteka, skirta priimti mokėjimus iš pirkėjo jūsų programėlėje.

Ji apima tą mokėjimo dalį, kuri turi vykti įrenginyje: atsiskaitymo puslapio arba kortelės formos rodymą, pirkėjo vedimą per EMV® 3-D Secure, nustatymą, kada mokėjimo eiga baigėsi, mokėjimo būsenos išsprendimą ir vieno rezultato perdavimą jūsų programėlei.

***

## Ką daro SDK

* Pateikia talpinamą atsiskaitymo puslapį [`WKWebView`](https://developer.apple.com/documentation/webkit/wkwebview) ir stebi jūsų grįžimo URL.
* Ne žiniatinklio navigacijas perduoda sistemai, kad atvirosios bankininkystės eiga galėtų persijungti į banko programėlę ir grįžti atgal.
* Užšifruoja kortelės duomenis įrenginyje ir valdo kortelės sesiją, kai naudojate savo kortelės formą.
* Pateikia EMV® 3-D Secure iššūkį ir užfiksuoja jo rezultatą.
* Nustato galutinę mokėjimo būseną ir jūsų programėlei pateikia tik vieną rezultatą.

## Ko SDK nedaro

**SDK neinicijuoja mokėjimų.** Mokėjimo inicijavimas autentifikuojamas naudojant OAuth 2.0 kliento kredencialus ir jūsų parduotuvės kliento slaptąjį raktą, o šis raktas niekada neturi būti įtrauktas į programėlę: bet kas, turintis jį, gali kurti mokėjimus jūsų parduotuvei. Mokėjimo inicijavimas turi vykti jūsų backend'e.

{% hint style="info" %}
SDK yra kliento pusės biblioteka. Jūsų backend'as sukuria mokėjimą ir lieka atsakingas už tai, ar jis buvo užbaigtas. Žr. [Integracija su backend'u](/seb-docs-draft/seb-docs-public-lt/integracija/mobilusis-sdk/ios-sdk/gaires/integracija-galineje-sistemoje.md).
{% endhint %}

***

## Jūsų atsakomybės

SDK apdoroja mokėjimo dalį įrenginyje. Už tai jūsų programėlė vis tiek atsakinga už:

* Mokėjimo inicijavimą jūsų backend'e ir gautų reikšmių perdavimą programėlei.
* Kliento kredencialų apsaugą.
* Jūsų programėlės pasiekiamo grįžimo URL registravimą.
* Užsakymų gyvavimo ciklo valdymą ir užsakymų įvykdymą iš savo backend'o, o ne iš programėlės.

{% hint style="danger" %}
**SDK rezultatą laikykite tik UX signalu, niekada ne kaip leidimu įvykdyti užsakymą.** Įrenginys gali prarasti ryšį tarp mokėjimo užbaigimo ir momento, kai jūsų programėlė apie tai sužino, todėl sumokėjęs pirkėjas ekrane vis tiek gali matyti nesėkmę. Užsakymo įvykdymą siekite su pranešimais, kuriuos platforma siunčia jūsų backend'ui.
{% endhint %}

## Įėjimo taškai

| Įėjimo taškas            | Metodas                                     | Naudokite, kai                                                                                     |
| ------------------------ | ------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| Priglobtas atsiskaitymas | `startPayment(_:from:completion:)`          | Norite visų platformos siūlomų mokėjimo būdų, o jūsų programėlėje neturi būti kortelės duomenų.    |
| Natyvi kortelės forma    | `startCardPayment(_:card:from:completion:)` | Norite, kad kortelės duomenys būtų renkami jūsų sąsajoje, stilizuotoje pagal jūsų dizaino sistemą. |

Abu įėjimo taškai veikia su tuo pačiu mokėjimu. Atskiro kortelės inicijavimo nėra, todėl programėlė, siūlanti abu variantus, atlieka vieną užklausą į backend'ą ir leidžia pirkėjui pasirinkti.

***

## Reikalavimai

| Reikalavimas       | Reikšmė                                       |
| ------------------ | --------------------------------------------- |
| Platforma          | iOS 15.0 arba naujesnė                        |
| Kalba              | Swift, kurią galima kviesti iš Objective-C    |
| Sąsajos sistema    | UIKit, su tiltu į SwiftUI                     |
| Įrankių grandinė   | Xcode 15 arba naujesnė                        |
| Priklausomybės     | Nėra                                          |
| Įtraukti ištekliai | Nėra. Visa SDK naudotojo sąsaja sukurta kodu. |

Viešoji API visur suderinama su Objective-C, todėl Objective-C programos palaikomos be tarpinio sluoksnio. Žr. [Objective-C ir SwiftUI](/seb-docs-draft/seb-docs-public-lt/integracija/mobilusis-sdk/ios-sdk/naudojant-sdk/objective-c-ir-swiftui.md).

***

## Aplinkos

SDK palaiko tiek Sandbox, tiek gamybinę aplinką.

| Aplinka          | Paskirtis                                   |
| ---------------- | ------------------------------------------- |
| Sandbox          | Kūrimas, testavimas ir integracijos patikra |
| Gamybinė aplinka | Tiesioginis mokėjimų apdorojimas            |

Aplinkos pasirinkimas atliekamas sukonfigūruojant tinkamus bazinius URL.  `aplinkos` ypatybė objekte `Configuration` yra informacinė: ji nekeičia jokio URL ir egzistuoja tam, kad jūsų kodas bei žurnalai galėtų atskirti vieną aplinką nuo kitos.

***

## Versijavimas ir palaikymas

SDK laikosi **MAJOR.MINOR.PATCH** versijavimo ir šiuo metu yra prieš 1.0, o tai reiškia, kad **smulkusis** leidimas gali pakeisti API.

Pririškite tikslią versiją arba leiskite iki kitos smulkiosios versijos. Neleiskite iki kitos pagrindinės versijos.

***

## Platinimas

SDK pateikiamas kaip kontrolinės sumos patikrintas ZIP archyvas, o ne kaip paketo saugyklos leidimas. Patikrinkite archyvą, išskleiskite jį ir įtraukite į savo projektą naudodami Swift Package Manager, CocoaPods arba iš anksto parengtą XCFramework. Žr. [Diegimas](/seb-docs-draft/seb-docs-public-lt/integracija/mobilusis-sdk/ios-sdk/idiegimas.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-lt/integracija/mobilusis-sdk/ios-sdk/apzvalga.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.