# Общая информация

**Платежный шлюз** представляет собой программное решение, которое обеспечивает интеграцию между платежным шлюзом и вашим приложением или веб-сайтом. Данный документ описывает подробности методов, необходимых для взаимодействия с платежным шлюзом.

***

## **Термины и сокращения**

 **API: Application Programming Interface** — набор готовых методов, предоставляемых приложением (системой) для использования во внешних программных продуктах.

**REST: Representational State Transfer** — архитектурный стиль взаимодействия компонентов распределенного приложения в сети.

**JSON: JavaScript Object Notation** — текстовый формат обмена данными, основанный на JavaScript RFC 7159.

**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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tarlanpayments.kz/platezhnyi-shlyuz/welcom.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.