Работа через страницу оплаты PAY
Общая информация по PAY
PAY - страница с интерфейсом для приема платежей через Интернет. Данный ресурс позволяет, независимо от способа оплаты, единообразно взаимодействовать с клиентом. Предоставляет выбор удобных клиенту методов и валюты для оплаты, и, при необходимости, дает возможность указать дополнительную информацию о плательщике (например, номер телефона, при оплате через мобильную коммерцию).
Выбор валюты и указание дополнительной информации для оплаты.
Если валюта выставленного счета не совпадает с валютой платежного направления, то PAY автоматически производит конвертацию суммы. Таким образом, магазин получит средства по выставленному счету в валюты счета, а клиент оплатит той валютой, которая для него удобна в настоящий момент.
Выставление счета для оплаты через PAY
Для перенаправления плательщика на страницу оплаты, необходимо сформировать и подтвердить HTML-форму.
URL: https://pay1.qostiq.com/ru/pay
Метод: POST, GET
Обязательные параметры: amount, currency, shop_id, shop_order_id, sign
Пример формирования подписи для запроса:
keys_sorted = ['amount', 'currency', 'shop_id', 'shop_order_id']
Строка для генерации sha256 хеша имеет вид:
10.00:980:1:101SecretKey01
HEX-представление хеша:
sign = 7354edb970dae3b496572252d7d7578fc8e0f1061b2e69a9eda1b39f3cdadc69
Пример HTML-формы:
<form name="Pay" method="post" action="https://pay.qostiq.com/ru/pay" accept-charset="UTF-8">
<input type="hidden" name="amount" value="10.00" />
<input type="hidden" name="currency" value="980" />
<input type="hidden" name="shop_id" value="1" />
<input type="hidden" name="sign" value="7354edb970dae3b496572252d7d7578fc8e0f1061b2e69a9eda1b39f3cdadc69" />
<input type="hidden" name="shop_order_id" value="101" />
<input type="submit"/>
<input type="hidden" name="description" value="Test invoice" />
</form>
Где,
| Параметр | Описание | Формат | Пример |
|---|---|---|---|
shop_id | идентификатор магазина в системе Qostiq | Integer | 5 |
amount | сумма выставленного счета | Number (Не больше 2х знаков после точки) | 1, 1.0, 1.00 или "1.00" |
currency | валюта выставленного счета | Integer | 840 - Доллар США, 980 - Украинская гривна, 978 - Евро |
description | описание к выставленному счету | String | "test payment" |
shop_order_id | номер счета на стороне магазина. В зависимости от настроек магазина, может проверяться на уникальность | String | "h8fj38dkh-hf8k-4f8d-9c8c-jd8dh38dksn92" |
sign | подпись, см. п. Правила формирования подписи (sign) | String | "a7f5bcbb774cea9d9886cbb3ce2f8731359e356a7d759437b4e9e31da1152109" |
Так же, платежная форма может содержать дополнительные параметры, которые не участвуют в формировании подписи, но влияют на вид страницы для оплаты PAY.
| Параметр | Описание | Формат | Пример |
|---|---|---|---|
payway | платежное направление, через которое необходимо оплатить выставленный счет, | String | "card_uah" (указан в личном кабинете) |
payer_account | email или номер кошелька аккаунта плательщика в системе Qostiq, если передается в запросе, то счет может оплатить только данный аккаунт. Только для оплаты с кошелька Qostiq. | String | "support@qostiq.com" или "201494711279" |
failed_url | URL, на который будет перенаправлен плательщик, после не успешной оплаты счета, | String | "https://qostiq.com/failed" |
success_url | URL, на который будет перенаправлен плательщик, после успешной оплаты счета | String | "https://qostiq.com/success" |
Важно! Success URL, Fail URL, указанные в настройках магазина, имееют приоритет выше переданных в запросе, поэтому необходимо удалить их из настроек магазина.
Общая информация по странице PAY (Crypto)
PAY - страница с интерфейсом для приема криптовалютных платежей которая предоставляет выбор удобного клиенту блокчейна оплаты и отображение клиенту адреса на который клиент может совершить платеж.
Выставление счета для оплаты через PAY страницу (Crypto)
Для перенаправления плательщика на страницу оплаты, необходимо сформировать и подтвердить HTML-форму.
URL (en): https://pay.qostiq.com/en/crypto/pay
URL (pl): https://pay.qostiq.com/pl/crypto/pay
URL (uk): https://pay.qostiq.com/uk/crypto/pay
URL (ru): https://pay.qostiq.com/ru/crypto/pay
Метод: POST, GET
Обязательные параметры: client, shop_id
Пример формирования подписи для запроса:
keys_sorted = ['client', 'shop_id']
Строка для генерации sha256 хеша имеет вид:
testclient:6SecretKey01
HEX-представление хеша:
sign = 0f5816c558d1150f76cf77694a80b50234b00fd26137dd1a3fbee168bfd9f7dc
**Пример URL запроса [GET]: **
**Пример HTML-формы [POST]: **
<form>
<input name="Pay" method="POST" action="https://pay.qostiq.com/ru/crypto/pay" accept-charset="UTF-8" />
<input type="hidden" name="client" value="testclient" />
<input type="hidden" name="paymethod_id" value="1" />
<input type="hidden" name="shop_id" value="6" />
<input type="hidden" name="email" value="client@example.com" />
<input type="hidden" name="return_url" value="https://shop.com/crypto_return_url" />
<input type="hidden" name="sign" value="0f5816c558d1150f76cf77694a80b50234b00fd26137dd1a3fbee168bfd9f7dc" />
<input type="submit" />
</form>
Где,
| Параметр | Описание | Формат | Обязательный | Пример |
|---|---|---|---|---|
client | Клиент для которого генерируется адрес | String | Да | "testclient" |
paymethod_id | Платежный метод (валюта оплаты и зачисления на магазин, при использовании данного параметра клиент самостоятельно выберет блокчейн оплаты) | String | *Опционально | 1 |
payway | Платежное направление (включает валюту и блокчейн оплаты) | String | *Опционально | "usdt_bep20" |
shop_id | идентификатор магазина в системе Qostiq | Integer | Да | 6 |
sign | подпись, см. п. Правила формирования подписи для операций с криптовалютой (sign) | String | Да | "0f5816c558d1150f76cf77694a80b50234b00fd26137dd1a3fbee168bfd9f7dc" |
email | Почта клиента | String | Нет | "client@example.com" |
return_url | URL на который клиент сможет вернуться со страницы оплаты по нажатию на кнопку "Вернуться в магазин" | String | Нет | "https://shop.com/crypto_return_url" |
*Для запроса обязателен один из параметров paymethod_id или payway.
При использовании параметра paymethod_id клиенту будет доступен выбор блокчейна (сети) оплаты;
при использовании payway у клиента не будет возможности выбора сети, клиент будет направлен на страницу с указанием адреса для оплаты.
Доступные значения paymethod_id:
Значение paymethod_id | Валюта |
|---|---|
1 | USDT |
2 | BNB |
3 | ETH |
4 | BTC |
5 | TRX |
6 | BUSD |
7 | LTC |
8 | MATIC |