Привязка карты

1. Создание транзакции для привязки карты с указанием project_client_id.

2. Создается платеж на 10тг.

3. Мерчант перенаправляет на страницу оплаты.

4. После проведения платежа происходит возврат 10тг.

Результат привязки карты мерчант можете узнать в методе получения списка привязанных карт пользователя, Webhook отправляется после списания средств. При последующих оплатах пользователю будут доступны ранее привязанные карты.

Создание транзакции для привязки карты

POST https://prapi.tarlanpayments.kz/transaction/api/v1/transaction/primal/card-link

Headers

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

Request Body

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

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": {}
}

curl --location 'https://prapi.tarlanpayments.kz/transaction/api/v1/transaction/primal/card-link'  \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer sign' \
--data-raw '{
    "callback_url": "https://test.site/callback_url",
    "description": "desc",
    "failure_redirect_url": "https://www.test.com",
    "merchant_id": 2222,
    "project_client_id": "999",
    "project_id": 111,
    "success_redirect_url": "https://www.test.com",
    "additional_data": {
        "test": "value",
        "qwerty": "123"
    }
}'