> 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/greita-pradzia.md).

# Greita pradžia

Šis gidas nuveda jus nuo įdiegto SDK iki vieno sėkmingo mokėjimo smėlio dėžėje per talpinamą atsiskaitymą. Tam reikia trijų reikšmių iš jūsų backend'o ir apie dvidešimties programos kodo eilučių.

## Būtinos sąlygos

* Jūsų projekte įdiegtas SDK. Žr. [Įdiegimas](/seb-docs-draft/seb-docs-public-lt/integracija/mobilusis-sdk/ios-sdk/idiegimas.md).
* Backendas, galintis sukurti mokėjimą. Žr. [Backendo integracija](/seb-docs-draft/seb-docs-public-lt/integracija/mobilusis-sdk/ios-sdk/gaires/integracija-galineje-sistemoje.md).
* Jūsų backend'o būsenos galinio taško smėlio dėžės bazinis URL.

***

## 1 žingsnis: gaukite mokėjimą iš savo backend'o

Jūsų backendas sukuria mokėjimą ir grąžina programėlei tris reikšmes:

| Reikšmė            | Iš kur gaunama                                                |
| ------------------ | ------------------------------------------------------------- |
| `paymentId`        | Laukas `paymentId` mokėjimo inicijavimo atsakymo.             |
| `verificationKey`  | Paskutinis kelio segmentas iš `_links.checkoutRedirect.href`. |
| `checkoutRedirect` | Laukas `_links.checkoutRedirect.href` pati reikšmė.           |

Jūsų backendas taip pat pasirenka `shopRedirectUrl` kurį siunčia inicijuodamas. Jūsų programa naudoja tą pačią reikšmę kaip savo grįžimo URL, todėl nuspręskite ją vieną kartą ir naudokite abiem.

[Backendo integracija](/seb-docs-draft/seb-docs-public-lt/integracija/mobilusis-sdk/ios-sdk/gaires/integracija-galineje-sistemoje.md) turi visą užklausą ir atsakymą.

## 2 žingsnis: užregistruokite savo grįžimo URL schemą

Jei jūsų grįžimo URL naudoja pasirinktinę schemą, deklaruokite ją savo programos `Info.plist`:

```xml
<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array><string>myapp</string></array>
    </dict>
</array>
```

Taip pat `https://` universalioji nuoroda taip pat veikia ir jai nereikia jokio `Info.plist` įrašo.

## 3 žingsnis: sukurkite mokėjimo rinkinį

Sukurkite vieną `PaymentKit` savo atsiskaitymo ekranui. `apiBaseURL` nukreipia į jūsų backendą, kurį SDK kviečia patvirtinti mokėjimo būseną, kai pirkėjas baigia atsiskaitymą.

```swift
import EGWPay

let configuration = Configuration(
    apiBaseURL: URL(string: "https://your-backend.example.com"),
    environment: .sandbox
)

let paymentKit = PaymentKit(configuration: configuration)
```

## 4 žingsnis: pradėkite mokėjimą

```swift
let request = PaymentRequest(
    paymentId: payment.paymentId,
    verificationKey: payment.verificationKey,
    checkoutURL: payment.checkoutRedirect,
    returnURL: URL(string: "myapp://checkout/return")!
)

paymentKit.startPayment(request, from: self) { result in
    switch result.outcome {
    case .succeeded:
        self.showReceipt(reference: result.orderNumber ?? result.paymentId)
    case .failed:
        self.showFailure(message: result.error?.localizedDescription)
    case .cancelled:
        break
    case .unresolved:
        self.confirmWithBackend(paymentId: result.paymentId)
    }
}
```

Paleiskite programą ir atlikite mokėjimą. Atsiskaitymo puslapis atsidaro, jūs užbaigiate mokėjimą, o grįžtamasis iškvietimas suveikia su `.succeeded`.

Kas įvyko automatiškai: SDK pateikė atsiskaitymo puslapį modaliniu langu, stebėjo kiekvieną navigaciją dėl jūsų grįžimo URL, uždarė savo sąsają vos tik pirkėjas baigė, paprašė jūsų backend'o mokėjimo būsenos ir pagrindinėje gijoje grąžino lygiai vieną rezultatą.

Smėlio dėžės bandomosios kortelės: [Testinės kortelės](/seb-docs-draft/seb-docs-public-lt/gaires/sandbox/bandomieji-duomenys.md#payment-cards)

***

## Apie `.unresolved`

`.unresolved` yra įprastas rezultatas, o ne klaida. Tai reiškia, kad SDK negalėjo nustatyti rezultato, dažniausiai todėl, kad mokėjimas dar vykdomas tuo metu, kai pirkėjas grįžta į jūsų programą. Paklauskite savo backend'o, o ne spėliokite. [Rezultato apdorojimas](/seb-docs-draft/seb-docs-public-lt/integracija/mobilusis-sdk/ios-sdk/naudojant-sdk/rezultato-apdorojimas.md) išsamiai aptaria kiekvieną baigtį.

{% hint style="danger" %}
**Nevykdykite užsakymo remdamiesi mokėjimo rezultatu.** Užsakymą vykdykite iš savo backend'o, remdamiesi platformos jam siunčiamais pranešimais. Rezultatas tik nurodo, ką rodyti ekrane, ir nieko daugiau.
{% endhint %}

***

## Kiti žingsniai

* [Talpinamas atsiskaitymas](/seb-docs-draft/seb-docs-public-lt/integracija/mobilusis-sdk/ios-sdk/naudojant-sdk/talpinamas-atsiskaitymas.md) - grįžimo URL atitikimas, mokėjimo metodo išankstinis parinkimas.
* [Natyvi kortelės forma](/seb-docs-draft/seb-docs-public-lt/integracija/mobilusis-sdk/ios-sdk/naudojant-sdk/natyvioji-korteles-forma.md) - surinkite kortelės duomenis savo vartotojo sąsajoje.
* [Rezultato apdorojimas](/seb-docs-draft/seb-docs-public-lt/integracija/mobilusis-sdk/ios-sdk/naudojant-sdk/rezultato-apdorojimas.md) - baigtys, grįžtamojo iškvietimo sutartis, pasirinktinė būsenos paieška.
* [Klaidų tvarkymas](/seb-docs-draft/seb-docs-public-lt/integracija/mobilusis-sdk/ios-sdk/gaires/klaidu-valdymas.md) - kiekvienas klaidos kodas ir kaip atsekti nesėkmę.


---

# 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/greita-pradzia.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.