Инициация приёма денежных средств

Приём средств без сохранённой карты

Создание транзакции на прием

POST https://prapi.tarlanpayments.kz/transaction/api/v1/transaction/primal/pay-in

Headers

Name	Type	Description
Authorization*	String	Bearer Авторизационный хэш (см Формирование подписи)

Request Body

Name	Type	Description
amount*	Float	Сумма платежа
project_client_id	String	Идентификатор клиента на стороне проекта
callback_url	String	URL проекта для оправки коллбэка со статусом транзакции (см Отправка callback)
failure_redirect_url*	String	Страница проекта на которую будет выполнен редирект пользователя после неуспешнй оплаты. Если параметр не был передан, редирект будет выполнен на success_redirect_url
merchant_id*	Integer	Идентификатор мерчанта присваиваемый платежной системой
project_id*	Integer	Идентификатор проекта присваиваемый платежной системой
project_reference_id*	String	Идентификатор заказа на стороне мерчанта
success_redirect_url*	String	Страница проекта на которую будет выполнен редирект пользователя после успешной оплаты
shipment	String	Адрес доставки
confirm_url	String	URL Проекта для подтверждения проведения оплаты (см. Подтверждение проведения оплаты)
description*	String	Описание платежа
additional_data	Object	Дополнительные параметры
project_order_id	String	Номер заказа на стороне проекта
is_hold	Bool	Указание на блокирование средств при проведении платежа

200: OK Пример успешного ответа

{
    "status": true,
    "message": "Success",
    "result": "https://process.tarlanpayments.kz?hash=$2a$10$nhrUYWm9sDVYqCL4LKxn9ugrdC4Pszz5wGaUsDYYIqCGc8ZA4Vu0y&transaction_id=100474"
}

500: Internal Server Error Пример ответа с ошибкой

{
    "status": false,
    "status_code": 5000,
    "message": "transaction already exists",
    "result": {}
}

Example of a CURL request:

curl --location 'https://prapi.tarlanpayments.kz/transaction/api/v1/transaction/primal/pay-in' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer sign' \
--data-raw '{
    "amount": 10,
    "callback_url": "https://test.site/callback_url",
    "confirm_url": "https://test.site/confirm_url",
    "description": "999",
    "failure_redirect_url": "https://www.test.com",
    "merchant_id": 9999,
    "project_client_id": "999",
    "project_id": 9999,
    "project_reference_id": "999",
    "shipment": "Tarlan ave, Payments str.",
    "success_redirect_url": "https://www.test.com",
    "additional_data": {
        "test1": "value1",
        "test2": 2
    }
}'

Платеж по сохраненной карте

При передаче параметра project_client_id у пользователя на форме оплаты появится возможность сохранения карты. Для сохранения карты, пользователю, на форме оплаты необходимо кликнуть "сохранить карту" и провести успешный платёж по этой карте.

Для последующих платежей по сохранённой карте необходимо передавать параметр project_client_id.

Особенностью платежа по сохранённой карте является отсутствие 3DS аутентификации пользователя, значительно ускоряющий и упрощающий процесс оплаты.