💡Создание счета

Для того, чтобы создать счет, и указать необходимые данные, необходимо воспользоваться API-системой

https://api.cispay.pro/payment/create

Используйте POST-запрос, и укажите данные в формате JSON по примеру ниже:

{
	"shop_to": "a33eb300-a120-3863-9950-1d6bc1df695a",
	"sum": 1.00,
	"comment": "Тестовый платеж",
	"hook_url": "https://cispay.pro/hook",
	"expire": 1500,
	"method": "card",
	"success_url": "https://cispay.pro/success",
	"subtract": 0
}

Параметр	Тип	Описание	Обязателен
shop_to	string	UUID мерчанта (нажмите на '?' рядом с ID мерчанта)	✅
sum	float	Сумма, с указанием двух знаков после точки	✅
comment	string	Комментарий, за что выставлен платеж	✅
custom_fields	string	Дополнительное поле	❌
hook_url	string	URL для отправки WebHook (параметр приоритетнее указанного в настройках URL) Если не указано, то WebHook будет отправлен на URL, указанный в настройках мерчанта	❌
expire	int	Время жизни счета в минутах	✅
method	string	Метод оплаты (список методов: здесь) Если не указано, то покупателю будет предложено выбрать между всеми доступными методами	❌
success_url	string	Ссылка для перенаправления клиента после оплаты счета	❌
subtract	int	С кого списывать комиссию: 1 - Списывать с клиента 0 - Списывать с магазина Если не указано, то значение, указанное в настройках мерчанта	❌

После успешного создания счета, система вернет ответ в виде:

{
	"status": "success",
	"uuid": "a3938999-155b-42ba-9e48-9fd0a8a8dc77",
	"url": "https://acquire.cispay.pro/a3938999-155b-42ba-9e48-9fd0a8a8dc77",
	"expire": 1685566800,
	"sum": 1.00
}

Параметр	Тип	Описание
status	string	Статус запроса
uuid	string	UUID платежа (позже узнать его можно из таблицы покупок, нажав на номер счета)
url	string	Ссылка на оплату счета
expire	int	Время истечения счета, в формате UNIX_TIMESTAMP
sum	float	Сумма, с указанием двух знаков после точки
custom_fields	string	Дополнительное поле (если есть)

Если счет был неудачно создан, или произошла ошибка, система вернет ответ в виде:

{
	"status": "error", // Статус запроса
	"message": "" // Текст ошибки
}

Пример создания счета

$shop_uuid = 'xxx'; // Укажите UUID мерчанта из панели

$data = json_encode([
   'shop_to' => $shop_uuid,
   'sum' => 100,
   'comment' => 'Оплата счета',
   'expire' => 1000,
   'subtract' => 0
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.cispay.pro/payment/create');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, false);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

if ($response['status'] == 'success') {
   // Счет создан успешно, можно добавить его UUID в базу данных своей системы
   $uuid = $response['uuid'];
   die(header('Location: '.$response['url'])); // Перенаправляем покупателя на страницу оплаты
}