> 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/sdk-izmantosana/mitinata-norekinu-lapa.md).

# Mitināta norēķinu lapa

Parādiet mitināto norēķinu lapu, saskaņojiet savu atgriešanas URL un iepriekš atlasiet maksājuma metodi.

Izmantojiet šo rokasgrāmatu, ja vēlaties, lai pircējs norēķinās mitinātajā norēķinu lapā, izmantojot visas platformas piedāvātās maksājumu metodes un bez kartes datiem jūsu lietotnē.

Lapa darbojas režīmā [`WKWebView`](https://developer.apple.com/documentation/webkit/wkwebview) SDK to parāda modāli. Karte, Pay by Bank, Click to Pay, maksājumu maki un EMV® 3-D Secure tur darbojas bez jebkādas papildu integrācijas no jūsu puses.

***

## Konfigurējiet

Mitinātajai norēķinu lapai nepieciešams viens URL: aizmugursistēma, kurai SDK pēc pircēja pabeigšanas pieprasa maksājuma statusu.

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

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

`apiBaseURL` ir jūsu pašu aizmugursistēma, jo tieši tai ir pamats pārvaldīt maksājuma stāvokli. SDK pievieno `/checkout/api/egw/v1/payments/{paymentId}` tam. Ja jūsu aizmugursistēma izmanto citādu ceļa struktūru, atstājiet `apiBaseURL` kā `nil` un tā vietā nodrošiniet savu meklēšanu: skatiet [Rezultāta apstrāde](/seb-docs-draft/seb-docs-public-lv/integracija/mobilais-sdk/ios-sdk/sdk-izmantosana/rezultata-apstrade.md).

Paturiet vienu `PaymentKit` visam norēķinu ekrāna darbības laikam vai izveidojiet vienu katram maksājumam. Abos gadījumos ir labi. Viena instance vienlaikus apstrādā vienu maksājumu. Pilns īpašību saraksts sadaļā [Configuration](broken://pages/4b0bcafe141a749244fd34ba29d90a88d367db7d).

***

## Izveidojiet pieprasījumu

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

`returnURL` jābūt tai pašai vērtībai, ko jūsu aizmugursistēma nosūtīja kā `shopRedirectUrl` kad tā izveidoja maksājumu.

SDK validē pieprasījumu pirms jebkādas parādīšanas, tāpēc tukšs `paymentId`, tukšs `verificationKey`, norēķinu URL, kas nav `http`/`https`, vai atgriešanās URL bez shēmas, visi atgriežas caur jūsu parasto atzvanu, nevis rāda tukšu tīmekļa skatu.

### Maksājuma metodes iepriekšēja izvēle

Pēc noklusējuma norēķinu lapa atveras ar metožu izvēlni. Lai atvērtu tieši ar vienu metodi:

```swift
request.preferredMethod = PaymentRequest.MethodHint.card
```

| Konstante                              | Vērtība          |
| -------------------------------------- | ---------------- |
| `PaymentRequest.MethodHint.card`       | `"card"`         |
| `PaymentRequest.MethodHint.bank`       | `"bank"`         |
| `PaymentRequest.MethodHint.clickToPay` | `"click-to-pay"` |

Netiek atpazīta vērtība tiek ignorēta, nevis pievienota, tāpēc drukas kļūda parāda metožu izvēlni, nevis sabojā norēķinu URL.

***

## Parādiet to

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

`no:` ir skata kontrolieris, virs kura SDK tiek parādīts. Tam jābūt redzamam ekrānā un tas nedrīkst jau rādīt ko citu.

SDK aizver savu saskarni pirms atbildes atzvana, tāpēc no atzvana iekšpuses parādīt kvīts ekrānu darbojas. Skatiet [Rezultāta apstrāde](/seb-docs-draft/seb-docs-public-lv/integracija/mobilais-sdk/ios-sdk/sdk-izmantosana/rezultata-apstrade.md) pilnam līgumam.

Arī `EGWPaymentDelegate`uz EGWPaymentDelegate balstīta pārslodze ir pieejama kā alternatīva pabeigšanas blokam. Skatiet [Objective-C un SwiftUI](/seb-docs-draft/seb-docs-public-lv/integracija/mobilais-sdk/ios-sdk/sdk-izmantosana/objective-c-un-swiftui.md).

***

## Kā tiek salīdzināts atgriešanās URL

SDK aptur plūsmu, kad pircēja pārlūkprogramma sasniedz jūsu atgriešanās URL. Salīdzināšana pārbauda **shēmu, hostu un ceļa prefiksu pa veseliem segmentiem**un ignorē vaicājuma parametru un fragmentu.

Atgriešanās URL `https://shop.example.com/pay/done` atbilst:

* `https://shop.example.com/pay/done`
* `https://shop.example.com/pay/done?order=1042#thanks`
* `https://shop.example.com/pay/done/thanks`

un neatbilst `https://shop.example.com/pay/done-not-really`, vai tam pašam ceļam citā hostā.

Vaicājuma daļa tiek ignorēta, jo varat brīvi pievienot savus parametrus `shopRedirectUrl`, un platforma nodod šo URL nemainītu.

{% hint style="warning" %}
**Atgriešanās URL sasniegšana nenozīmē, ka maksājums bija veiksmīgs.** Tam netiek pievienots statuss. Tāpēc SDK pēc tam statusu pieprasa, un tāpēc jūsu lietotne nedrīkst nolasīt rezultātu no paša URL.
{% endhint %}

### Pielāgotas shēmas un universālās saites

Abas darbojas, un SDK tās abas uztver identiski.

Pielāgota shēma, piemēram, `myapp://checkout/return` ir vienkāršākā izvēle un to nevar sajaukt ar īstu tīmekļa lapu. Universālo saiti ir vērts dot priekšroku, ja jums tā jau ir iestatīta vai ja tas pats atgriešanās URL tiek koplietots ar tīmekļa norēķiniem. [Aizmugursistēmas integrācija](/seb-docs-draft/seb-docs-public-lv/integracija/mobilais-sdk/ios-sdk/celvezi/backend-integracija.md) aptver katras iestatīšanu.

### Nodošana citām lietotnēm

Pārejas uz ne-tīmekļa shēmām tiek nodotas sistēmai, nevis ielādētas tīmekļa skatā. Tas ļauj Pay by Bank plūsmai atvērt pircēja bankas lietotni stingrai klienta autentifikācijai un pēc tam atgriezties jūsu lietotnē.

***

## Noildzes

`requestTimeout` ierobežo paša SDK API izsaukumu laiku. Nevienam tīmekļa skatam netiek piemērota noildze: pircējs, kas lasa bankas apstiprinājuma ekrānu, nav iestrēdzis pieprasījums.

***

## Nākamie soļi

* [Rezultāta apstrāde](/seb-docs-draft/seb-docs-public-lv/integracija/mobilais-sdk/ios-sdk/sdk-izmantosana/rezultata-apstrade.md)
* [Kļūdu apstrāde](/seb-docs-draft/seb-docs-public-lv/integracija/mobilais-sdk/ios-sdk/celvezi/kludu-apstrade.md)
* [Vietējā kartes forma](/seb-docs-draft/seb-docs-public-lv/integracija/mobilais-sdk/ios-sdk/sdk-izmantosana/nativa-kartes-forma.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-lv/integracija/mobilais-sdk/ios-sdk/sdk-izmantosana/mitinata-norekinu-lapa.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.