Это самый простой способ принятия платежей от ваших Клиентов.

Свой сайт не обязателен, знания программирования не требуются и начать принимать платежи можно в несколько кликов.

Если вы при создании формы выбрали сайт, на котором будете размещать эту форму, и при добавлении сайта указали Status, Success и Fail Url, то после оплаты, клиенты будут перенаправлены к вам на сайт и Azvox передаст информацию о платеже по указанному StatusUrl.

Этот способ создания счетов удобный и быстрый, но не всем подходит, так как он не позволяет автоматически генерировать описание заказа и его сумму.
Если вам это необходимо и вам не достаточно функциональности платёжных форм - смотрите следующий способ.

Если ваш сайт использует PHP и у вас есть минимальные знания программирования, то этот способ именно то, что вам требуется.

С помощью этого класса вы можете создавать счёта, используя всего несколько строк кода.

Создание счёта используя PHP класс cAzvox.php:Скопировать код
<?php
	require_once "Путь до файла Azvox API/cAzvox.php";
	$api = new cAzvox(
		"Главный номер вашего Azvox кошелька (W12345)",
		"Api ID( указан в списке ваших API )",
		"Пароль для доступа к API"
	);

	// $shop_id это ID вашего сайта в Azvox, можно найти в списке ваших сайтов.
	// Либо укажите 0, если хотите просто создать счёт для оплаты, не относящийся к вашему сайту.
	$shop_id = 12345;

	// $order_id это ID заказа в вашей системе учёта, если у вас нет ID заказа, укажите 0.
	$order_id = 123;
	$data = array(
		"m_shop" => $shop_id,
		"m_orderid" => $order_id,
		"m_amount" => 100.15, // Сумма заказа
		"m_curr" => "USD", // Валюта заказа USD, EUR или RUB
		"m_desc" => "Description", // Описание вашего заказа, которое увидит покупатель
	);

	// Если вы хотите, чтобы Azvox при отчёте о платеже вернул вам дополнительные данные, раскоментируйте строку ниже и добавьте их в массив как указано в примере
	// $data["m_params"] = json_encode(array("var1" => "value1", "var2" => "value2"));

	$newInvoice = $api->createInvoice($data);
	$errors = $api->getErrors();
	if (!$errors){
		echo '<a href="'.$newInvoice['pay_url'].'">Оплатить</a>';
	}else{
		print_r($errors);
	}
?>

$newInvoice:Скопировать код
Array(
    [invoice_id] => Номер счёта в Azvox
    [m_orderid] => ID заказа, который вы указали при создании счёта $order_id
    [pay_url] => Ссылка на страницу оплаты счёта, по которой вам нужно отправить Клиента
)

Если ваш сайт не поддерживает PHP и вы используете другой язык программирования, то вам нужно обращаться к Azvox API по протоколу HTTPS.

Подробнее об этом смотрите ниже. Для создания счёта смотрите пункт new_invoice

Предыдущие способы создания счёта через API удобны, но имеют один недостаток.
У вашего API есть тарифный план, в соответствии с которым есть ограничения на количество запросов в секунду и в минуту.

По умолчанию выбран бесплатный тариф (Free)
В нём ограничение не более 1 запроса в секунду и не более 6 запросов в минуту.
Если вы хотите использовать способы создания счёта через API и считаете, что для ваших целей недостаточно такого количества запросов, тогда вы можете выбрать другой тарифный план в разделе API.

Но также вы можете создавать счета и другим способом, позволяющим получить полный контроль над формированием формы для оплаты.

На странице вашего сайта нужно сформировать форму для оплаты:

Пример формы:Скопировать код
<form method="post" action="https://azvox.cash/pay/">
	<input type="hidden" name="m_shop" value="12345">
	<input type="hidden" name="m_orderid" value="123">
	<input type="hidden" name="m_amount" value="100.15">
	<input type="hidden" name="m_curr" value="USD">
	<input type="hidden" name="m_desc" value="dGVzdA==">
	<input type="hidden" name="m_sign" value="12A315A26EE2E255E181EFBE35AD0C396338159B7B6ADFE2A02313EF06233678">
	<input type="hidden" name="m_params" value="eyJwYXJhbV9jdXIiOiJVU0QifQ==">
	<input type="submit" name="m_process" value="Pay">
</form>

Либо указать прямую ссылку на оплату, если нет возможности отправлять запрос на страницу оплаты методом POST:

Пример ссылки:Скопировать код
<a href="https://azvox.cash/pay/?m_shop=12345&m_orderid=123&m_amount=100.15&m_curr=USD&m_desc=dGVzdA==&m_sign=12A315A26EE2E255E181EFBE35AD0C396338159B7B6ADFE2A02313EF06233678">
	Можно оплатить по прямой ссылке
</a>

Расшифровка параметров формы

PHP код:Скопировать код
<?php echo base64_encode('test'); ?>

PHP код:Скопировать код
<?php echo base64_encode(json_encode(array(
	"var1" => "value1",
	"var2" => "value2",
	"var3" => "value3"
))); ?>

PHP код:Скопировать код
<?php
	$m_shop = 12345; // ID вашего сайта в Azvox
	$m_key = 'jSp3%13v5hYLaXb'; // Секретный ключ, указанный в настройках вашего сайта
	$m_amount = 100.52; // Сумма платежа
	$m_curr = 'USD'; // Валюта платежа
	$m_orderid = 123; // ID заказа в вашей системе учёта
	$m_desc = 'Описание платежа, которое увидит клиент при оплате.';

	$m_params = false;
	// Список необязательных параметров, которые вы можете передать в форму
	// Azvox отправит их вам, в скрипт обработчика платежа StatusUrl
	// Передавайте их только в том случае, если отправляете запрос методом POST
	// $m_params = array("var1" => "value1", "var2" => "value2", "var3" => "value3");

	$m_amount = number_format($m_amount, 2, ".", "");
	$m_desc = base64_encode($m_desc);
	$m_params = base64_encode(json_encode($m_params));
	$arHash = array($m_shop,$m_orderid,$m_amount,$m_curr,$m_desc,$m_params,$m_key);
	$m_sign = strtoupper(hash('sha256', implode(':', $arHash)));
?>

<form method="post" action="https://azvox.cash/pay/">
	<input type="hidden" name="m_shop" value="<?=$m_shop;?>">
	<input type="hidden" name="m_orderid" value="<?=$m_orderid;?>">
	<input type="hidden" name="m_amount" value="<?=$m_amount;?>">
	<input type="hidden" name="m_curr" value="<?=$m_curr;?>">
	<input type="hidden" name="m_desc" value="<?=$m_desc;?>">
	<input type="hidden" name="m_sign" value="<?=$m_sign;?>">
	<input type="hidden" name="m_params" value="<?=$m_params;?>">
	<input type="submit" name="m_process" value="Pay">
</form>

PHP код:Скопировать код
<?php
	$m_shop = 12345; // ID вашего сайта в Azvox
	$m_key = 'jSp3%13v5hYLaXb'; // Секретный ключ, указанный в настройках вашего сайта
	$m_amount = 100.52; // Сумма платежа
	$m_curr = 'USD'; // Валюта платежа
	$m_orderid = 123; // ID заказа в вашей системе учёта
	$m_desc = 'Описание платежа, которое увидит клиент при оплате.';

	$m_params = false; // Не учитывается при методе GET, но этот код необходим для генерации цифровой подписи m_sign

	$m_amount = number_format($m_amount, 2, ".", "");
	$m_desc = base64_encode($m_desc);
	$m_params = base64_encode(json_encode($m_params));
	$arHash = array($m_shop,$m_orderid,$m_amount,$m_curr,$m_desc,$m_params,$m_key);
	$m_sign = strtoupper(hash('sha256', implode(':', $arHash)));

	$pay_by_link = array("m_shop" => $m_shop, "m_orderid" => $m_orderid, "m_amount" => $m_amount, "m_curr" => $m_curr, "m_desc" => $m_desc, "m_sign" => $m_sign);
	$pay_by_link = "https://azvox.cash/pay/?".http_build_query($pay_by_link);
?>

<a href="<?=$pay_by_link;?>">Можно оплатить по прямой ссылке</a>

В процессе оплаты счёта Клиент может оплатить его, либо отказаться от оплаты.

В обоих случаях клиенту будет предложено вернуться на ваш сайт и в этом случае он будет перенаправлен на SuccessUrl или FailUrl соответственно.

Также Azvox обратится к вашему скрипту обработчику платежей (StatusUrl) и сообщит ему статус оплаты, чтобы вы могли обработать счёт(заказ) на своей стороне.

По этому адресу Клиенту будет предложено перейти, в случае успешной оплаты счёта.

Имейте в виду, что клиент может не переходить по указанному адресу.

Не обрабатывайте платёж или какие-либо важные данные в этом скрипте, так как любой человек может перейти по этому адресу и подделать параметры, которые передаются в этот скрипт.

Используйте этот скрипт только как уведомление о том, что оплата прошла успешно, либо перенаправьте Клиента из скрипта в нужный вам раздел.

Пример скрипта успешной оплаты - SuccessUrl:Скопировать код
<?php
	header('Content-Type: text/html; charset=utf-8');

	// Этот параметр передаётся только в том случае, если вы отправили запрос из раздела Azvox - тестирование сайта
	$testOnly = isset($_POST["testOnly"])?true:false;

	$m_shop = 0;
	$m_orderid = 0;
	$m_amount = 0;
	$m_curr = "";
	$m_params = "";
	if (isset($_GET['success'])){
		if (isset($_GET['m_shop'])){$m_shop = (int)$_GET['m_shop'];}
		
		// Проверка, что переданный параметр m_shop соответствует вашему сайту
		if ($m_shop == "ID вашего сайта в Azvox"){

			// ID заказа в вашей системе учёта
			if (isset($_GET['m_orderid'])){$m_orderid = (int)$_GET['m_orderid'];}

			// Сумма платежа, которая была зачислена продавцу(отличается от суммы, которую оплатил Клиент)
			if (isset($_GET['m_amount'])){$m_amount = $_GET['m_amount'];}

			// Валюта платежа
			if (isset($_GET['m_curr'])){$m_curr = $_GET['m_curr'];}

			// в m_params будут переданы данные, заполненные Клиентом, только в том случае, если счёт был оплачен через платёжную форму созданную в Azvox
			if (isset($_GET['m_params'])){$m_params = $_GET['m_params'];}

			if ($m_params != ""){$m_params = base64_decode($m_params);}

			if ($m_orderid > 0){
				// В этм месте проверьте принадлежит ли этот $m_orderid тому Клиенту, который пришёл по этому адресу
				// Если всё верно, покажите клиенту сообщение об успешной оплате
				// Ни в коем случае не отмечайте в этом скрипте заказ успешным, делайте это в скрипте StatusUrl
				echo 'Оплата заказа номер '.$m_orderid.' успешно завершена. Сумма заказа: '.$m_amount.' '.$m_curr;
				exit;
			}
		}
	}
	echo "ERROR";
	exit;
?>

По этому адресу Клиенту будет предложено перейти, в случае если он откажется от оплаты счёта.

Имейте в виду, что клиент может не переходить по указанному адресу.

Не обрабатывайте платёж или какие-либо важные данные в этом скрипте, так как любой человек может перейти по этому адресу и подделать параметры, которые передаются в этот скрипт.

Используйте этот скрипт только как уведомление о том, что оплата отклонена Клиентом, либо перенаправьте Клиента из скрипта в нужный вам раздел.

Пример скрипта отказа от оплаты - FailUrl:Скопировать код
<?php
	header('Content-Type: text/html; charset=utf-8');

	// Этот параметр передаётся только в том случае, если вы отправили запрос из раздела Azvox - тестирование сайта
	$testOnly = isset($_POST["testOnly"])?true:false;

	$m_shop = 0;
	$m_orderid = 0;
	$m_amount = 0;
	$m_curr = "";
	$m_params = "";
	if (isset($_GET['fail'])){
		if (isset($_GET['m_shop'])){$m_shop = (int)$_GET['m_shop'];}
		
		// Проверка, что переданный параметр m_shop соответствует вашему сайту
		if ($m_shop == "ID вашего сайта в Azvox"){

			// ID заказа в вашей системе учёта
			if (isset($_GET['m_orderid'])){$m_orderid = (int)$_GET['m_orderid'];}

			// Сумма платежа, которая должна была быть зачислена продавцу
			if (isset($_GET['m_amount'])){$m_amount = $_GET['m_amount'];}

			// Валюта платежа
			if (isset($_GET['m_curr'])){$m_curr = $_GET['m_curr'];}

			// в m_params будут переданы данные, заполненные Клиентом, только в том случае, если счёт был создан через платёжную форму созданную в Azvox
			if (isset($_GET['m_params'])){$m_params = $_GET['m_params'];}

			if ($m_params != ""){$m_params = base64_decode($m_params);}

			if ($m_orderid > 0){
				// В этм месте проверьте принадлежит ли этот $m_orderid тому Клиенту, который пришёл по этому адресу
				// Если всё верно, покажите клиенту сообщение о том, что он отказался от оплаты счёта
				// Ни в коем случае не отмечайте в этом скрипте заказ завершённым или отклонённым, делайте это в скрипте StatusUrl
				echo 'Вы отказались от оплаты заказа номер '.$m_orderid.'. Сумма заказа: '.$m_amount.' '.$m_curr;
				exit;
			}
		}
	}
	echo "ERROR";
	exit;
?>

По этому адресу Azvox обратится когда Клиент оплатит счёт, либо откажется от оплаты счёта.

Имейте в виду, что Клиент не переходит по этому адресу и не знает его адрес.

Обрабатывайте платёж, отмечайте его оплаченным, либо отменённым, только в этом скрипте, и только после соответствующих проверок.

Обязательно проверяйте на своей стороне не обрабатывали ли вы ранее этот платёж, чтобы не зачислить покупку повторно.
В некоторых случаях Azvox может отправлять данные несколько раз.

StatusUrl должен ответить текстом $m_orderid|success.
Пример: 123|success
Иначе Azvox будет отправлять запросы повторно, с перерывом в несколько минут, пока не получит нужный ответ.
Но не более 10 раз.
Также вы можете переотправить запрос из раздела История, нажав на кнопку Подробнее, возле соответствующей транзакции.

Параметры, которые Azvox отправляет вашему StatusUrl методом POST

Пример скрипта обработчика платежей - StatusUrl:Скопировать код
<?php
	header('Content-Type: text/html; charset=utf-8');

	if (isset($_POST['m_status']) && isset($_POST['m_shop']) && isset($_POST['m_orderid']) && isset($_POST['m_operation_id']) && isset($_POST['m_sign'])){
		
		$testOnly = isset($_POST["testOnly"])?true:false;
		
		$m_key = "Секретный ключ, указанный в настройках вашего сайта";
		$m_shop = "ID вашего сайта в Azvox";

		$arHash = array(
			$_POST['m_status'],
			$_POST['m_operation_id'],
			$_POST['m_operation_amount'],
			$_POST['m_operation_curr'],
			$_POST['m_operation_timestamp'],
			$_POST['m_wallet'],
			$_POST['m_shop'],
			$_POST['m_orderid'],
			$_POST['m_amount'],
			$_POST['m_curr'],
			$_POST['m_desc'],
			$_POST['m_params'],
			$m_key
		);

		// Генерируем подпись
		$sign_hash = strtoupper(hash('sha256', implode(':', $arHash)));

		$m_status = $_POST['m_status'];
		$m_shopid = (int)$_POST['m_shop'];
		
		// Сверяем подпись и остальные параметры
		if ($_POST['m_sign'] == $sign_hash && ($m_shopid == $m_shop) && ( ($m_status == 'success') || ($m_status == 'fail') )){
			
			$operation_id = $_POST['m_operation_id'];
			$operation_amount = $_POST['m_operation_amount'];
			$operation_curr = $_POST['m_operation_curr'];
			$real_pay_date = $_POST['m_operation_timestamp'];
			$m_wallet = $_POST['m_wallet'];

			$m_orderid = (int)$_POST['m_orderid'];
			$m_amount = $_POST['m_amount'];
			$m_curr = $_POST['m_curr'];
			$m_desc = $_POST['m_desc'];
			$m_params = $_POST['m_params'];
			
			$m_desc = base64_decode($m_desc);
			$m_params = json_decode(base64_decode($m_params), true);

			$is_all_ok = false;

			if ($m_status == 'success'){
				// Счёт был оплачен и можно отметить его у вас, как оплаченный
				// В этом месте вам нужно найти в своей системе учёта счёт $m_orderid и проверить
				// существует ли данный счёт, не был ли он обработан ранее, верна ли сумма и валюта платежа
				// Если всё верно, то обработать его и сделать переменную $is_all_ok = true
				$is_all_ok = true; // Если все ваши проверки пройдены успешно и счёт вы обработали, то присваиваем переменной true
			}elseif ($m_status == 'fail'){
				// Клиент отказался от оплаты счёта. Если требуется, найдите этот счёт у себя и отметьте, что клиент отменил счёт
				$is_all_ok = true; // Тут аналогично. Если все ваши проверки пройдены успешно и счёт вы обработали, то присваиваем переменной true
			}
			
			if ($is_all_ok){
				echo $m_orderid.'|success';
				exit;
			}
		}
	}
	echo "ERROR";
	exit;
?>