API для приёма оплат
Приём оплат Kaspi в вашем проекте через API
Создайте платёж запросом из своего сайта или приложения, покажите клиенту страницу оплаты с QR-кодом и получите вебхук, когда оплата пройдёт. Работает с вашей собственной кассой Kaspi.
curl -X POST https://pay.mtech.kz/api/v1/payments -u CLIENT_ID:CLIENT_SECRET -H "Content-Type: application/json" -d '{"amount": 12500,
"description": "Заказ №1042",
"external_order_id": "order-1042"}'
# Ответ 201
{ "id": "pay_8Hk2xQ4mTz9wLc",
"status": "pending",
"amount": 12500,
"payment_page_url":
"https://pay.mtech.kz/pay/pay_8Hk2xQ4mTz9wLc" }Всё для приёма оплаты
Всё, что нужно, чтобы принимать оплату Kaspi в своём проекте и быть уверенным в статусе каждого платежа.
REST API
Один запрос создаёт платёж и возвращает QR-код, ссылку на оплату и адрес страницы оплаты. Суммы — в целых тенге.
Вебхуки с подписью HMAC
Сообщаем вашему серверу об оплате, отмене и возврате. Каждый запрос подписан секретом — подпись легко проверить.
Страница оплаты с QR
Покажите клиенту готовую страницу: сумма, QR-код Kaspi, таймер и автообновление статуса. Ничего верстать не нужно.
Идемпотентность
Повторный запрос с тем же ключом не создаст второй платёж — безопасно повторять при сбоях сети.
Кабинет и журнал
История платежей, фильтры, поиск по номеру заказа и журнал доставки уведомлений по каждому платежу.
Безопасность
Ключи API хранятся только в виде хэшей, их можно выпускать и отзывать, а секреты кассы шифруются.
Как это работает
Четыре шага от регистрации до первого оплаченного заказа.
Подключите кассу
Зарегистрируйтесь и подключите собственную кассу Kaspi в кабинете.
Получите ключи
Выпустите ключ API и укажите адрес для вебхуков. Ключ показывается один раз.
Создайте платёж
Отправьте запрос из вашего проекта — получите QR-код и адрес страницы оплаты.
Получите вебхук об оплате
Когда клиент заплатит, мы сообщим вашему серверу. Статус всегда можно проверить запросом.
Разработчикам
Простой REST API с понятными ответами и подробной документацией: примеры запросов, коды ошибок, формат вебхуков и проверка подписи.
- Авторизация по client_id и client_secret — ключи выпускаются и отзываются в кабинете
- Вебхук с подписью HMAC-SHA256 и автоматическими повторами
- Заголовок Idempotency-Key для безопасных повторов
- Статус платежа можно запросить в любой момент
POST https://your-site.kz/webhooks/mtech
X-MTech-Event: payment.paid
X-MTech-Signature: 9f2c…e1
{ "type": "payment.paid",
"data": { "id": "pay_8Hk2xQ4mTz9wLc",
"status": "paid",
"amount": 12500,
"external_order_id": "order-1042" } }Поля примера условные: точный формат — в документации API.
Важно
MTech Pay — независимый сервис ИП MT TECH. Сервис не является продуктом, партнёром или представителем АО «Kaspi Bank». Kaspi и Kaspi.kz — товарные знаки их правообладателей. Приём оплат подключается: пока касса не подключена, платежи не проводятся.
Частые вопросы
Можно ли принимать оплату прямо сейчас?
Кабинет, API и страница оплаты уже работают. Сами платежи начнут проходить после подключения вашей кассы Kaspi — пока касса не подключена, платежи не проводятся.
Как узнать, что клиент оплатил?
Двумя способами: мы отправим подписанный вебхук на ваш адрес, а статус платежа можно запросить через API по его номеру.
Нужен ли программист?
Для подключения через API — да, интеграцию можно поручить подрядчику. Принять разовую оплату вручную можно и прямо из кабинета.
Сколько это стоит?
Если стоимость использования предусмотрена, мы сообщим о ней заранее — до того, как она начнёт применяться.
Вы храните деньги клиентов?
Нет. MTech Pay не банк и не хранит денежные средства. Платежи обрабатывает платёжный провайдер на своих условиях.
Как с вами связаться?
Напишите на support@mtech.kz — ответим по вопросам подключения и работы сервиса.
Подключите оплату Kaspi к своему проекту
Создайте кабинет, получите ключи API и отправьте первый платёж.