Создание ссылки на оплату

ВНИМАНИЕ: Новый формат ответа для ошибок

В ближайшее время в нашей системе ошибки будут разделены на ожидаемые и неожидаемые. Это приведет к изменению формата JSON-ответа в зависимости от типа ошибки. Пожалуйста, ознакомьтесь с изменениями на странице Коды Ошибок. Изменения будут применены ко всем API в системе AGWS, за исключением методов «Проведение платежа» и «Проверка статуса пополнения».

Нажмите здесь, чтобы просмотреть старые и новые ответы об ошибках JSON. Обратите внимание на это обновление и убедитесь, что ваша система готова к изменениям, если это необходимо.

POST https://agwsapi.tarlanpayments.kz/showcase-gateway/api/v1/action/link

Headers

Name	Value
Content-Type	application/json
X-Signature	Авторизационный хэш

Body

Name	Type	Description
agent*	String	Код витрины в системе Tarlanpayments
username*	String	Идентификатор пользователя
amount*	Integer	Сумма транзакции
service*	String	Название услуги
return_url	String	Ссылка для перехода после оплаты
refer_host*	String	Домен с которого производится оплата

Response

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

{
    "status": true,
    "message": "Success",
    "status_code": 0,
    "result": {
        "code": 0,
        "redirect_url": "https://kaspi.kz/pay/quickpayment?quick_pay_id=Betssonkzad1e50a5-6afd-481e-8e14-37487734ed292517:52:00",
        "message": "Успешно обработано",
        "qr_code_image": ""
    }
}

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

404 Not Found

{
    "status": false,
    "status_code": 9718,
    "message": "provider not found",
    "result": {}
}

400 Bad Request

{
    "status": false,
    "status_code": 1014,
    "message": "Invalid signature",
    "result": {}
}

Примеры ответов об ошибках после внесения изменений

200 OK: Ожидаемая ошибка

{
    "status": true,
    "status_code": 0,
    "message": "Success",
    "result": {
        "error_code": 1881,
        "code": -1,
        "message": "provider doesn't exists",
        "redirect_url": "",
        "qr_code_image": ""
    }
}

400 Bad Request: Неожидаемая ошибка

{
    "status": false,
    "status_code": 1014,
    "message": "Invalid signature",
    "result": {}
}

curl --location 'https://agwsapi.tarlanpayments.kz/showcase-gateway/api/v1/action/link' \
--header 'X-Signature: qfqer1231' \
--header 'Content-Type: application/json' \
--data '{
    "agent": "test1",
    "user_id": "e41e6e7b-a0b9-46cf-ac10-bb8333fd6391",
    "amount": 10000,
    "service": "service1",
    "return_url": "https://www.youresite.com/",
    "refer_host": "site.kz"
}'