Платёж без использования API
Интеграция без использования методов платежного API выполняется путём предварительного создания ссылки на оплату или ручным созданием счёта в личном кабинете.
Создание счёта на оплату в личном кабинете
В личном кабинете, в разделе Счета при нажатии на Создать счёт отобразится форма, где заполняются параметры
- Срок действия(обязателен) - срок, в течение которого будет действовать счёт на оплату
- Сумма к оплате(обязательна) - сумма к оплате.
- Id клиента(необязательно) - идентификатор клиента в системе мерчанта
- Комментарий(необязательно) - краткое описание оплачиваемой услуги/товара
Итогом будет получение ссылки на оплату, которую требуется передать клиенту. Клиент, перейдя по ссылке попадёт на платёжную форму.
После оплаты статус счёта поменяется на оплачен. Если оплата прошла не успешно, по каким-то причинам, то клиент может по этой же ссылке повторить попытку оплаты.
Создание ссылки на оплату
Можно создать постоянную ссылку с заранее указанными параметрами: сумма, валюта, комментарий... Когда покупатель открывает ссылку, ему автоматически выставляется счет и отображается Платежная форма. Параметры счета необходимо передать в ссылке на Платежную форму — см. ниже примеры и список параметров.
Тестовый url https://test.qiwip.kz/api/create
Боевой url https://qiwip.kz/api/create
GET .../api/create?{parameter_1}={value_1}&{parameter_2}={value_2}
** Параметры**
В URL query указываются параметры счета.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
siteId | string | Да | Идентификатор siteId мерчанта |
amount | number | Да | Сумма операции (округленная до двух десятичных знаков в меньшую сторону). Например 100.23 или 100.00 |
currency | enum | Да | KZT, USD, EUR, RUB |
comment | string | Нет | Комментарий, наименование товара или услуги |
account | string | Нет | Идентификатор клиента в системе мерчанта |
successUrl | string | Нет | Ссылка на сайт магазина в случае успеха в URL Encoded |
failedUrl | string | Нет | Ссылка на сайт магазина в случае отказа в URL Encoded |
sign | string | Да | Подпись |
Подпись - строка аутентификации HMAC-SHA256,
где secret key - ключ доступа к API, а строка формируется по формату: amount|currency|siteId
Например:
ключ доступа к API - 5628af1c-26d9-42e7-8a6a-c22d491d79fb
amount - 10.00
currency - KZT
siteId - testst-01
account - 1234567
Строка для подписи - 10.00|KZT|testst-01
Строка аутентификации(sign) - 7ba07711e4d3a96165ed0bf02546baa4f4dea94f72285d86cb210f5359dbb458
Строка запроса будет выглядеть так:
GET https://test.qiwip.kz/api/create?siteId=testst-01&amount=10.00¤cy=KZT&account=1234567&sign=7ba07711e4d3a96165ed0bf02546baa4f4dea94f72285d86cb210f5359dbb458