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

# Ātrais sākums

Šī pamācība izved jūs no instalēta SDK līdz vienam veiksmīgam testvides maksājumam, izmantojot hostētu norēķinu lapu. No jūsu aizmugursistēmas tā izmanto trīs vērtības un apmēram divdesmit lietotnes koda rindas.

## Priekšnosacījumi

* Projektā instalēts SDK. Skatīt [Instalēšana](/seb-docs-draft/seb-docs-public-lv/integracija/mobilais-sdk/ios-sdk/uzstadisana.md).
* Aizmugursistēma, kas var izveidot maksājumu. Skatīt [Aizmugursistēmas integrācija](/seb-docs-draft/seb-docs-public-lv/integracija/mobilais-sdk/ios-sdk/celvezi/backend-integracija.md).
* Testvides bāzes URL jūsu aizmugursistēmas statusa galapunktam.

***

## 1. solis: iegūstiet maksājumu no savas aizmugursistēmas

Jūsu aizmugursistēma izveido maksājumu un atgriež lietotnei trīs vērtības:

| Vērtība            | No kurienes tā nāk                                        |
| ------------------ | --------------------------------------------------------- |
| `paymentId`        | Lauks `paymentId` maksājuma uzsākšanas atbildes lauks.    |
| `verificationKey`  | Pēdējais ceļa segments no `_links.checkoutRedirect.href`. |
| `checkoutRedirect` | Lauks `_links.checkoutRedirect.href` pašas vērtības.      |

Jūsu aizmugursistēma arī izvēlas `shopRedirectUrl` to, ko tā nosūta uzsākšanas brīdī. Jūsu lietotne kā atgriešanās URL izmanto to pašu vērtību, tāpēc to izvēlieties vienreiz un koplietojiet starp abiem.

[Aizmugursistēmas integrācija](/seb-docs-draft/seb-docs-public-lv/integracija/mobilais-sdk/ios-sdk/celvezi/backend-integracija.md) satur pilno pieprasījumu un atbildi.

## 2. solis: reģistrējiet savu atgriešanās URL shēmu

Ja jūsu atgriešanās URL izmanto pielāgotu shēmu, deklarējiet to savas lietotnes `Info.plist`:

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

Arī `https://` universālā saite arī darbojas un neprasa nekādu `Info.plist` ierakstu.

## 3. solis: izveidojiet PaymentKit

Izveidojiet vienu `PaymentKit` savam norēķinu ekrānam. `apiBaseURL` norāda uz jūsu pašu aizmugursistēmu, kuru SDK izmanto, lai apstiprinātu maksājuma statusu, kad pircējs ir pabeidzis.

```swift
import EGWPay

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

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

## 4. solis: sāciet maksājumu

```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)
    }
}
```

Palaidiet lietotni un veiciet maksājumu. Norēķinu lapa atveras, jūs pabeidzat maksājumu, un atpakaļsaukums tiek izsaukts ar `.succeeded`.

Kas notika automātiski: SDK parādīja norēķinu lapu modālā logā, uzraudzīja katru navigāciju, lai atrastu jūsu atgriešanās URL, aizvēra savu saskarni tiklīdz pircējs pabeidza, pieprasīja maksājuma statusu no jūsu aizmugursistēmas un galvenajā pavedienā piegādāja tieši vienu rezultātu.

Testkartes testvidē: [Testkartes](/seb-docs-draft/seb-docs-public-lv/celvezi/smilskaste/testa-dati.md#payment-cards)

***

## Par `.unresolved`

`.unresolved` ir normāls rezultāts, nevis kļūda. Tas nozīmē, ka SDK nevarēja noteikt rezultātu, visbiežāk tāpēc, ka maksājums vēl ir procesā brīdī, kad pircējs atgriežas jūsu lietotnē. Jautājiet savai aizmugursistēmai, nevis miniet. [Rezultāta apstrāde](/seb-docs-draft/seb-docs-public-lv/integracija/mobilais-sdk/ios-sdk/sdk-izmantosana/rezultata-apstrade.md) detalizēti apraksta katru iznākumu.

{% hint style="danger" %}
**Neizpildiet pasūtījumu, balstoties uz maksājuma rezultātu.** Izpildi veiciet no savas aizmugursistēmas, pamatojoties uz platformas tai nosūtītajiem paziņojumiem. Rezultāts pasaka tikai to, ko rādīt ekrānā, un neko vairāk.
{% endhint %}

***

## Nākamie soļi

* [Hostēts norēķins](/seb-docs-draft/seb-docs-public-lv/integracija/mobilais-sdk/ios-sdk/sdk-izmantosana/mitinata-norekinu-lapa.md) - atgriešanās URL saskaņošana, maksājuma metodes iepriekšēja izvēle.
* [Vietējā kartes forma](/seb-docs-draft/seb-docs-public-lv/integracija/mobilais-sdk/ios-sdk/sdk-izmantosana/nativa-kartes-forma.md) - apkopojiet kartes datus savā lietotāja saskarnē.
* [Rezultāta apstrāde](/seb-docs-draft/seb-docs-public-lv/integracija/mobilais-sdk/ios-sdk/sdk-izmantosana/rezultata-apstrade.md) - iznākumi, atpakaļsaukuma līgums, pielāgota statusa vaicāšana.
* [Kļūdu apstrāde](/seb-docs-draft/seb-docs-public-lv/integracija/mobilais-sdk/ios-sdk/celvezi/kludu-apstrade.md) - katrs kļūdas kods un kā izsekot kļūmei.


---

# 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/ios-sdk/atrais-sakums.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.
