# Жалпы ақпарат

**Төлем шлюзі** мен сіздің қосымшаңыз немесе веб-сайтыңыз арасындағы интеграцияны қамтамасыз ететін бағдарламалық шешім болып табылады. Бұл құжат төлем шлюзімен өзара іс-қимыл жасау үшін қажетті әдістердің егжей-тегжейлерін сипаттайды.

***

### Терминдер мен қысқартулар

 **API: Application Programming Interface** — Application Programming Interface – сыртқы бағдарламалық өнімдерде пайдалану үшін қосымшамен (жүйемен) ұсынылатын дайын әдістердің жиынтығы.

**REST: Representational State Transfer** — желідегі үлестірілген қосымша компоненттерінің өзара іс-қимылының архитектуралық стилі.

**JSON: JavaScript Object Notation** — RFC 7159 JavaScript негізделген деректер алмасудың мәтіндік форматы.

**3DS: 3-D Secure** — интернет арқылы төлем операцияларын жасау кезінде банк картасын ұстаушыны сәйкестендіру үшін пайдаланылатын карточкалық деректерді қорғау хаттамасы. Tarlan Payments хаттаманың 3DS 1.0 нұсқасын да, 3DS 2.0 нұсқасын да қолдайды.

**ТСП, Мерчант** — Жүйемен жұмыс істейтін сауда-сервистік кәсіпорын.

**Проект (Жоба)—** әріптестің (мерчанттың) еншілес мәні. Мерчантқа заңды тұлғаларды, терминалдарды, сондай-ақ есептерді ажыратуға мүмкіндік береді.

**Мерчант(серіктес)** – қызметтерді жүзеге асыру, тауарларды сату және т.б. үшін ақшалай қаражат алуға мүмкіндігі бар заңды тұлға. Сондай-ақ жобалардың біріктіруші мәні болып табылады.

**Құпия кілт** – Жобаны сәйкестендіру үшін пайдаланылатын оны авторландыруға арналған символдық жол.

**Төлем токені** – Акцептісіз төлемдер үшін картаның деректері бойынша жасалған символ жолы.

***

### Имплементациялау кезеңдері

1. Қосылуға өтінімді [tarlanpayments.kz ](https://tarlanpayments.kz/)сайтында қалдырыңыз

*Өтінімді өңдегеннен кейін Қолдау қызметінің менеджері сіздермен қосылудың ықтимал нұсқаларын талқылайды, қажетті құжаттарды сұрайды, банктермен бірігу процесін, шартты, терминалды құруды іске қосады.*

2. Жеке кабинетке рұқсаттама алыңыз.\
   \&#xNAN;*Төлемдерді қабылдау хаттамасына қосылған кезде сіз мерчанттың бірегей сәйкестендіргішін және Жеке кабинетке рұқсаттама аласыз. Қол жеткізу параметрлері тіркелу кезінде көрсетілген e-mail-ге жіберіледі.*
3. API-ге рұқсаттама кілтін шығарыңыз.

   *API-ге рұқсаттама кілті API-мен өзара әрекеттесу үшін пайдаланылады. Аккаунт-менеджерден API кілтін алыңыз.*
4. Өзара әрекеттестікті тестілеңіз.\
   \&#xNAN;*Қосылғанда сіздің сәйкестендіргішіңіз тестілік режимде болады. Осы режимде сіз операцияларды банк картасынан қаражатты есептен шығармай жүргізе аласыз.*

Сіздің тарапыңыздағы интеграция аяқталған кезде, біз сіздің project\_id сәйкестендіргішіңізді өндірістік режимге ауыстырамыз.

**Назар аударыңыз!** Өндірістік режимде қаражатты картадан нақты есептен шығару орындалады.

### Кері байланыс

Сұрақтар мен ұсыныстарды мына мекенжайға жіберуге болады:

 [support@tarlanpayments.kz](mailto:support@onevision.kz)

Сондай-ақ, [ресми сайттағы](https://tarlanpayments.kz/) «Байланыстар» бөлімінде көрсетілген деректемелер бойынша