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

# Mitinātā norēķinu lapa

Pieņemiet tiešsaistes maksājumus, izmantojot drošu norēķinu lapu, ko mitina E-komercijas maksājumu vārteja.

Hosted Checkout nodrošina gatavu maksājumu saskarni, kur klienti var izvēlēties pieejamo maksājuma veidu, ievadīt vai apstiprināt savus maksājuma datus un pabeigt jebkādu nepieciešamo autentifikāciju.

Jūsu serveris izveido maksājumu, izmantojot Merchant API, un saņem Payment ID un norēķinu URL. Jūs novirzāt klientu uz šo URL un apstiprināt maksājuma rezultātu, izmantojot atpakaļizsaukuma paziņojumus un Merchant API.

{% hint style="warning" %}
**Neuztveriet klienta atgriešanos jūsu vietnē vai lietotnē kā maksājuma apstiprinājumu.** Izmantojiet atpakaļizsaukuma paziņojumu kā trigeri, izgūstiet aktuālo maksājuma informāciju no Gateway un izpildiet pasūtījumu tikai pēc tam, kad esat apstiprinājis nepieciešamo apmaksāto statusu.
{% endhint %}

### Kāpēc izmantot Hosted Checkout?

Hosted Checkout ir laba izvēle, ja vēlaties pieņemt vairākus maksājuma veidus, neveidojot un neuzturot savu maksājumu saskarni.

| Gateway apstrādā                                | Jūs ieviešat                                       |
| ----------------------------------------------- | -------------------------------------------------- |
| Klientam redzamā maksājumu lapa                 | Jūsu pasūtījuma un norēķinu plūsma                 |
| Maksājuma veida izvēli                          | create-payment API pieprasījumu                    |
| Maksājuma akreditācijas datu savākšanu          | Payment ID glabāšanu                               |
| Klienta autentifikāciju                         | Klienta novirzīšanu                                |
| Nodošanu bankām un maka pakalpojumu sniedzējiem | Atpakaļizsaukuma paziņojumu apstrādi               |
| Adaptīvu norēķinu pieredzi                      | Statusa apstiprināšanu un pasūtījuma atjaunināšanu |

Hosted Checkout var samazināt jūsu integrācijas darbu un jūsu sistēmu pakļautību sensitīviem kartes datiem. Tā kā maksājumu lapa darbojas Gateway vidē, maksājuma akreditācijas datiem nav jāplūst caur jūsu lietotni. Jūs joprojām esat atbildīgi par piemērojamo PCI DSS prasību ievērošanu.

#### Apsveriet Hosted Checkout, ja vēlaties

* Gatavu maksājumu lapu.
* Vairākus maksājuma veidus ar vienu integrāciju.
* Autentifikācijas plūsmas, ko apstrādā Gateway.
* Adaptīvu pieredzi darbvirsmā un mobilajās ierīcēs.
* Uz konfigurāciju balstītu zīmolvedību, nevis pilnībā pielāgotu maksājumu lietotāja saskarni.

#### Apsveriet citu integrāciju, ja jums nepieciešams

* Pilnīga kontrole pār maksājumu lapas izkārtojumu un darbību.
* Iespēja savā saskarnē savākt maksājuma informāciju.
* Pielāgota norēķinu loģika, kas nav pieejama, izmantojot Hosted Checkout konfigurāciju.

Skatiet **Izvēlieties savu integrāciju** lai salīdzinātu Hosted Checkout ar Merchant API, Web Plugins un Mobile SDK.

### Kā

```mermaid
sequenceDiagram
    participant C as Customer
    participant M as Merchant
    participant G as Ecommerce Payment Gateway
    participant P as Bank / Payment Provider

    C->>M: Sāk norēķinus
    M->>G: Izveido maksājumu
    G-->>M: Payment ID + Checkout URL
    M->>M: Saglabā Payment ID

    M-->>C: Novirza uz Hosted Checkout
    C->>G: Izvēlas maksājuma veidu
    G->>P: Apstrādā maksājumu / autentifikāciju
    P-->>G: Maksājuma rezultāts

    G-->>C: Novirza atpakaļ pie tirgotāja

    G-->>M: Atpakaļizsaukuma paziņojums

    M->>G: Iegūst maksājuma informāciju
    G-->>M: Pašreizējais maksājuma statuss

    M->>M: Atjaunina pasūtījumu
```

Plūsma sastāv no pieciem galvenajiem soļiem:

1. Jūsu serveris izveido klienta iniciētu maksājumu.
2. Gateway atgriež Payment ID un norēķinu URL.
3. Jūs saglabājat Payment ID un novirzāt klientu.
4. Klients pabeidz maksājumu Hosted Checkout vidē.
5. Jūsu backend apstiprina rezultātu, izmantojot atpakaļizsaukumu un Merchant API.

Hosted Checkout var parādīt kartes, digitālos makus, Pay by Bank un citas maksājuma metodes, kas ir iespējotas veikalam un attiecināmas uz darījumu. Precīzs klienta ceļš ir atkarīgs no izvēlētā maksājuma veida, taču tirgotāja integrācija paliek nemainīga.

### Pirms sākat

Pārliecinieties, ka jums ir:

* Sandbox veikals.
* Veikala OAuth akreditācijas dati.
* Iespējoti nepieciešamie maksājuma veidi.
* HTTPS URL, uz kuru klients var atgriezties.
* HTTPS Callback URL maksājumu paziņojumiem.
* Tirgotāja pasūtījums, ko var sasaistīt ar Gateway Payment ID.

Pirms izstrādes sākšanas konfigurējiet Sandbox akreditācijas datus, atgriešanās URL, Callback URL un maksājuma veidus. Sandbox un Production konfigurācijas tiek pārvaldītas atsevišķi.

Skatiet:

* **Ātrās darba sākšanas pamācību**
* **Integrācijas kontrolsaraksts**
* **Merchant Portal — Shop Settings**
* **Autentifikācija**
* **Testēšanas/Sandbox ceļvedis**

### Integrējiet Hosted Checkout

#### 1. Izveidojiet maksājumu

No sava backend izmantojiet Merchant API, lai izveidotu klienta iniciētu maksājumu.

Sniedziet informāciju, kas nepieciešama maksājuma identificēšanai un apstrādei, tostarp:

* Jūsu veikalu.
* Jūsu tirgotāja pasūtījuma numuru.
* Maksājuma summu un valūtu.
* URL, uz kuru klientam jāatgriežas.

Ja piemērojams, varat norādīt arī papildu pasūtījuma, klienta, adreses, groza, lokalizācijas un token iestatīšanas informāciju.

Pašreizējā Merchant API dokumentācija apraksta Hosted Checkout kā vienu no veidiem, kā turpināt klienta iniciētu maksājumu pēc tā izveides. API izmanto OAuth 2.0 Client Credentials un pieprasa unikālu pieprasījuma identifikatoru.

Skatiet **Merchant API — Izveidot klienta iniciētu maksājumu** pilnai pieprasījuma shēmai, validācijas noteikumiem un piemēriem.

{% hint style="info" %}
Aprēķiniet maksājuma summu savā serverī. Neuzticieties summai, ko piegādā tikai pārlūkprogrammas vai mobilā klienta kods.
{% endhint %}

#### 2. Saglabājiet Payment ID

create-payment atbilde identificē maksājumu un nodrošina URL, kas tiek izmantots, lai atvērtu Hosted Checkout.

Pirms novirzāt klientu, saglabājiet Payment ID pret savu tirgotāja pasūtījumu.

Tas jums būs nepieciešams, lai:

* Iegūtu pašreizējo maksājuma statusu.
* Apstrādātu atpakaļizsaukuma paziņojumus.
* Atrastu maksājumu Merchant Portal.
* Saskaņotu maksājumu ar pasūtījumu.
* Izmeklētu darījumu kopā ar atbalstu.

{% hint style="info" %}
**Saglabājiet Payment ID, pirms novirzāt klientu.**
{% endhint %}

Katram pasūtījumam izmantojiet unikālu tirgotāja pasūtījuma numuru vai atsauci, lai atvieglotu saskaņošanu un problēmu novēršanu.

***

#### 3. Novirziet klientu

Novirziet klienta pārlūkprogrammu uz Gateway atgriezto norēķinu URL.

Izmantojiet URL tieši tā, kā tas ir atgriezts. Neradiet, nemainiet un neizmantojiet atkārtoti Hosted Checkout URL citam pasūtījumam.

Hosted Checkout klients var:

1. Pārskatīt maksājuma informāciju.
2. Izvēlēties pieejamo maksājuma veidu.
3. Ievadīt vai apstiprināt savus maksājuma datus.
4. Pabeigt autentifikāciju, ja tā ir nepieciešama.
5. Atgriezties jūsu vietnē vai lietotnē.

Lapu mitina Gateway, un tā ir izstrādāta darbam dažādās atbalstītās darbvirsmas, planšetdatoru un mobilo ierīču vidēs.

Klientam rādītie maksājuma veidi var būt atkarīgi no:

* Tirgotāja līguma un veikala konfigurācijas.
* Valūtas un tirgus.
* Klienta valsts.
* Ierīces un pārlūkprogrammas atbalsta.
* Ārējās bankas, maka vai pakalpojumu sniedzēja pieejamības.

Skatiet **Maksājuma veidi** konkrēta veida pieejamībai, autentifikācijai, statusiem un klienta ceļiem.

### Apstrādājiet maksājuma rezultātu

Hosted Checkout izmanto divus atsevišķus atgriešanās ceļus.

| Pārlūkprogrammas atgriešanās             | Atpakaļizsaukuma paziņojums                            |
| ---------------------------------------- | ------------------------------------------------------ |
| Atgriež klientu jūsu vietnē vai lietotnē | Paziņo jūsu backend, ka maksājuma statuss ir mainījies |
| Izmanto klienta pieredzei                | Izmanto pasūtījuma apstrādes uzsākšanai                |
| Atkarīgs no klienta pārlūkprogrammas     | Tiek piegādāts neatkarīgi no klienta                   |
| Klients var nekad neatgriezties          | Neveiksmīga piegāde tiek atkārtota                     |
| Nav maksājuma apstiprinājums             | Jāseko maksājuma informācijas izgūšanai                |

Klients var aizvērt pārlūkprogrammu, zaudēt savienojumu vai pamest maksājuma procesu, neatgriežoties jūsu vietnē. Tādēļ jūsu pasūtījums nedrīkst būt atkarīgs tikai no pārlūkprogrammas novirzīšanas.

#### Kad klients atgriežas

Izmantojiet atgriešanās lapu, lai parādītu atbilstošu ziņojumu, piemēram:

* Maksājums veiksmīgs.
* Maksājums joprojām tiek apstrādāts.
* Maksājums atcelts.
* Maksājums neizdevās.

Jūsu atgriešanās lapa var pieprasīt jūsu backend jaunāko zināmo pasūtījuma statusu. Tā nedrīkst patstāvīgi izpildīt pasūtījumu tikai tāpēc, ka klients ir nonācis šajā lapā.

Ja galīgais statuss vēl nav pieejams, saglabājiet pasūtījumu gaidīšanas režīmā un informējiet klientu, ka apstiprināšana joprojām notiek.

#### Kad saņemat atpakaļizsaukumu

Pēc atpakaļizsaukuma saņemšanas:

1. Apstipriniet paziņojuma saņemšanu.
2. Iegūstiet aktuālo maksājuma informāciju, izmantojot autentificēto API.
3. Pārbaudiet, vai maksājums pieder gaidītajam pasūtījumam un veikalam.
4. Atjauniniet pasūtījumu, pamatojoties uz apstiprināto maksājuma statusu.
5. Nodrošiniet, ka izpilde tiek veikta tikai vienu reizi.

Atpakaļizsaukums identificē maksājumu un tā jauno statusu. Gateway dokumentācija norāda tirgotājiem pēc paziņojuma saņemšanas izgūt aktuālos maksājuma datus. Neveiksmīgas atpakaļizsaukumu piegādes tiek atkārtotas ar pieaugošu aizkavi.

Neizmantojiet tikai atpakaļizsaukuma saturu kā vienīgo patieso avotu. Atpakaļizsaukumu apstrāde, atkārtoti mēģinājumi, dublēta piegāde, idempotence un saskaņošana ir aprakstīta **Atpakaļizsaukuma paziņojumi**.

### Izpildiet pasūtījumu

Izpildiet pasūtījumu tikai pēc tam, kad esat izgūstis un apstiprinājis atbilstošu apmaksāto statusu.

| Apstiprinātais nosacījums                        | Ieteicamā darbība                           |
| ------------------------------------------------ | ------------------------------------------- |
| Kartes maksājums ir iekasēts                     | Uzskatiet pasūtījumu par apmaksātu          |
| Pay by Bank maksājums ir norēķināts              | Uzskatiet pasūtījumu par apmaksātu          |
| Maksājums joprojām tiek apstrādāts               | Saglabājiet pasūtījumu gaidīšanas statusā   |
| Maksājums ir autorizēts, bet nav iekasēts        | Neuzskatiet to par pilnībā apmaksātu        |
| Maksājums ir atcelts, neizdevās vai tika pamests | Neizpildiet                                 |
| Maksājums ir atmaksāts                           | Atjauniniet pasūtījumu un finanšu ierakstus |

Apmaksātais statuss atšķiras atkarībā no maksājuma veida. Piemēram, Pay by Bank gadījumā maksājums izmanto `SETTLED` nevis kartēm specifisko `AUTHORIZED` un `CAPTURED` modeli.

Skatiet:

* **Maksājuma statusi**
* **Kartes**
* **Maksājums ar banku**
* **Atpakaļizsaukuma paziņojumi**

### Klienta pieredze un pielāgošana

Hosted Checkout var konfigurēt tā, lai tas atspoguļotu jūsu vizuālo identitāti, izmantojot jūsu veikalam iespējotās opcijas.

Atkarībā no jūsu konfigurācijas un piekļuves tiesībām pielāgošana var ietvert:

* Tirgotāja logotipu.
* Primārās un sekundārās krāsas.
* Atbalstītos fontus.
* Pogu un stūru stilus.
* Noklusējuma valodu.
* Maksājuma veidu redzamību, kārtošanu un grupēšanu.
* Darbvirsmas un mobilā priekšskatījumu.

Pielāgošana aprobežojas ar Gateway nodrošinātajām iespējām. Tā neļauj mainīt drošības vadīklas, autentifikācijas plūsmas, maksājumu apstrādes loģiku vai pakalpojumu sniedzēja kontrolētas saskarnes.

Hosted Checkout sākotnējā risinājuma ietvaros atbalsta angļu, latviešu, igauņu un lietuviešu valodu. Angļu valoda tiek izmantota kā rezerves valoda. Lapa var izvēlēties atbalstītu valodu, pamatojoties uz konfigurēto preferenci vai klienta pārlūkprogrammas vai ierīces lokalizāciju.

Ārējie ekrāni var izskatīties citādi nekā Hosted Checkout. Piemēram, klients var tikt nodots uz:

* Sava kartes izdevēja 3-D Secure izaicinājumu.
* Savu banku Pay by Bank autentifikācijai.
* Maka pakalpojumu sniedzēju, piemēram, PayPal, Apple Pay vai Google Pay.

Skatiet **Merchant Portal — Checkout Page Builder** pieejamajām konfigurācijas opcijām.

### Pārbaudiet savu integrāciju

Pabeidziet visu izstrādi un validāciju Sandbox vidē, pirms pieprasāt Production aktivizāciju.

Hosted Checkout pārbaudiet vismaz:

* Veiksmīgu maksājumu.
* Noraidītu vai neveiksmīgu maksājumu.
* Klienta atcelšanu.
* Klienta pamestību.
* Klientu, kurš samaksā, bet neatgriežas jūsu vietnē.
* Atpakaļizsaukuma piegādi un maksājuma statusa izgūšanu.
* Katru jūsu veikalam iespējoto maksājuma veidu.
* Klienta ceļus darbvirsmā un mobilajās ierīcēs.

Vispārējais integrācijas kontrolsaraksts arī paredz, ja piemērojams, pārbaudīt novirzīšanu, atpakaļizsaukuma paziņojumus, pasūtījuma apstiprināšanu, atmaksas, iekasēšanu, reversēšanu un dublikātu apstrādi.

Sandbox nodrošina ierobežotu Hosted Checkout pieredzi un ne vienmēr ietver visas Production funkcijas vai maksājuma veidus.

Skatiet **Testēšanas/Sandbox ceļvedis** par:

* Testa maksājuma dati.
* Sandbox atbalstītie maksājuma veidi.
* Autentifikācijas scenāriji.
* Sagaidāmie statusi.
* Kļūdu un atcelšanas gadījumi.
* Atpakaļizsaukuma noturības testēšana.

### Sāciet darbu tiešsaistē

Pirms dzīvu maksājumu apstrādes:

* Pabeidziet **Darba uzsākšanas kontrolsaraksts**.
* Aktivizējiet un konfigurējiet Production veikalu.
* Ģenerējiet Production akreditācijas datus.
* Konfigurējiet Production atgriešanās un Callback URL.
* Apstipriniet iespējotos maksājuma veidus un valūtas.
* Pārskatiet Hosted Checkout zīmolvedību un valodas.
* Veiciet kontrolētu, mazas vērtības Production maksājumu.
* Pārbaudiet atpakaļizsaukumu apstrādi, pasūtījumu atjauninājumus un saskaņošanu.

Production vidē neizmantojiet Sandbox akreditācijas datus vai galapunktus.

### Nākamie soļi

Turpiniet ar jūsu ieviešanai atbilstošo dokumentāciju:

* **Tirgotāja API** — izveidot maksājumus un izgūt maksājuma informāciju.
* **Atpakaļizsaukuma paziņojumi** — uzticami apstrādāt maksājuma statusa izmaiņas.
* **Testēšanas/Sandbox ceļvedis** — testa dati un pilna cikla scenāriji.
* **Maksājuma veidi** — kartes, maki un Pay by Bank.
* **Maksājuma statusi** — izprast maksājumu dzīves ciklu un tirgotāja darbības.
* **Merchant Portal — Shop Settings** — akreditācijas dati un tehniskie URL.
* **Merchant Portal — Checkout Page Builder** — zīmolvedība un norēķinu konfigurācija.
* **Drošība un atbilstība** — PCI DSS un tirgotāja drošības atbildības.
* **Darba uzsākšanas kontrolsaraksts** — sagatavot jūsu integrāciju Production videi.


---

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