This is the easiest way to accept payments from your Clients.

Your own website is not required, programming knowledge is not required and you can start accepting payments in a few clicks.

If you selected the site where you will place this form when creating the form, and when adding the site you specified Status, Success and Fail Url, then after payment, clients will be redirected to your site and Azvox will transfer information about the payment to the specified StatusUrl.

This method of creating invoices is convenient and fast, but it does not suit everyone, since it does not allow you to automatically generate an order description and payment amount.
If you need this and the functionality of payment forms is not enough for you, see the next method.

If your site uses PHP and you have minimal programming knowledge, then this method is exactly what you need.

With this class you can create invoices using just a few lines of code.

Creating an invoice using PHP class cAzvox.php:Copy code
<?php
	require_once "cAzvox.php";
	$api = new cAzvox(
		"Main number of your Azvox wallet (W12345)",
		"Api ID (specified in the list of your APIs)",
		"Password for API access"
	);

	// $shop_id is ID of your site in Azvox, can be found in the list of your sites.
	// Or enter 0 if you just want to create an invoice for payment that is not associated to your site.
	$shop_id = 12345;

	// $order_id is the order ID in your accounting system, if you don't have an order ID, enter 0.
	$order_id = 123;
	$data = array(
		"m_shop" => $shop_id,
		"m_orderid" => $order_id,
		"m_amount" => 100.15, // Order amount
		"m_curr" => "USD", // Order currency USD, EUR or RUB
		"m_desc" => "Description", // Description of your order that the client will see
	);

	// If you want Azvox to return additional data when reporting about payment, uncomment the line below and add it to the array as shown in the example
	// $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'].'">Pay</a>';
	}else{
		print_r($errors);
	}
?>

$newInvoice:Copy code
Array(
    [invoice_id] => Azvox Invoice ID
    [m_orderid] => Order ID, you specified when creating the invoice $order_id
    [pay_url] => Link to the invoice payment page that you need to send the Client to
)

If your site does not support PHP and you use another programming language, you need to access the Azvox API via HTTPS.

See below for more details. To create an invoice, see new_invoice

The previous methods of creating an invoice via API are convenient, but have one drawback.
Your API has a tariff plan, according to which there are limits on the number of requests per second and per minute.

By default, the free plan is selected (Free)
It has a limitation of no more than 1 request per second and no more than 6 requests per minute.
If you want to use API invoice creation methods and think that this number of requests is not enough for your purposes, then you can choose another plan in the API section.

But you can also create invoices in another way that allows you to have full control over the creation of the payment form.

You need to create a payment form on your website page:

Form example:Copy code
<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="12A315A26EE2D255E180EFBE35AD0C376338159B7B6ADFE2B02313EF06233676">
	<input type="hidden" name="m_params" value="eyJwYXJhbV9jdXIiOiJVU0QifQ==">
	<input type="submit" name="m_process" value="Pay">
</form>

Or specify a direct link to payment if it is not possible to send a request to the payment page using the POST method:

Link example:Copy code
<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">
	You can pay via direct link
</a>

Description of form parameters

PHP code:Copy code
<?php echo base64_encode('test'); ?>

PHP code:Copy code
<?php echo base64_encode(json_encode(array(
	"var1" => "value1",
	"var2" => "value2",
	"var3" => "value3"
))); ?>

PHP code:Copy code
<?php
	$m_shop = 12345; // Your site ID in Azvox
	$m_key = 'jSp3%13v5hYLaXb'; // Secret key provided in your site settings
	$m_amount = 100.52; // Payment amount
	$m_curr = 'USD'; // Payment currency
	$m_orderid = 123; // Order ID in your accounting system
	$m_desc = 'Payment description that the client will see when paying.';

	$m_params = false;
	// List of optional parameters that you can pass to the form
	// Azvox will send them to your payment processing script at StatusUrl
	// $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 code:Copy code
<?php
	$m_shop = 12345; // Your site ID in Azvox
	$m_key = 'jSp3%13v5hYLaXb'; // Secret key provided in your site settings
	$m_amount = 100.52; // Payment amount
	$m_curr = 'USD'; // Payment currency
	$m_orderid = 123; // Order ID in your accounting system
	$m_desc = 'Payment description that the client will see when paying.';

	$m_params = false; // Ignored when the GET method used, but this code is required to generate the m_sign digital signature

	$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;?>">You can pay via direct link</a>

During the payment process, the Client can either complete the payment or cancel it.

In both cases, the client will be given the option to return to your site, and client will be redirected to SuccessUrl or FailUrl accordingly.

Azvox will also call your payment processing script (StatusUrl) and report the payment status so you can process the invoice (order) on your side.

This address will be suggested to the Client in case of successful payment of the invoice.

Keep in mind that the client may not navigate to the specified address.

Do not process the payment or any important data in this script, as anyone can navigate to this address and spoof the parameters passed to this script.

Use this script only as a notification that the payment was successful, or redirect the Client from the script to the desired section.

Example of Successful Payment Script - SuccessUrl:Copy code
<?php
	header('Content-Type: text/html; charset=utf-8');

	// This parameter is only passed if you sent the request from the Azvox section - site testing
	$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'];}
		
		// Check that the passed m_shop parameter matches your site
		if ($m_shop == "Your site ID in Azvox"){

			// Order ID in your accounting system
			if (isset($_GET['m_orderid'])){$m_orderid = (int)$_GET['m_orderid'];}

			// Payment amount credited to the seller (different from the amount paid by the Client)
			if (isset($_GET['m_amount'])){$m_amount = $_GET['m_amount'];}

			// Payment currency
			if (isset($_GET['m_curr'])){$m_curr = $_GET['m_curr'];}

			// m_params will contain data filled in by the Client only if the invoice was paid through the payment form created in Azvox
			if (isset($_GET['m_params'])){$m_params = $_GET['m_params'];}

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

			if ($m_orderid > 0){
				// At this point, check if this $m_orderid belongs to the Client who came to this address
				// If everything is correct, show the client a message about the successful payment
				// Under no circumstances should you mark the order as successful in this script, do this in the StatusUrl script
				echo 'Order number '.$m_orderid.' has been successfully completed. Order amount: '.$m_amount.' '.$m_curr;
				exit;
			}
		}
	}
	echo "ERROR";
	exit;
?>

This address will be suggested to the Client if they decline to pay the invoice.

Keep in mind that the client may not navigate to the specified address.

Do not process the payment or any important data in this script, as anyone can navigate to this address and spoof the parameters passed to this script.

Use this script only as a notification that the payment was declined by the Client, or redirect the Client from the script to the desired section.

Example of Payment Decline Script - FailUrl:Copy code
<?php
	header('Content-Type: text/html; charset=utf-8');

	// This parameter is only passed if you sent the request from the Azvox section - site testing
	$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'];}
		
		// Check that the passed m_shop parameter matches your site
		if ($m_shop == "Your site ID in Azvox"){

			// Order ID in your accounting system
			if (isset($_GET['m_orderid'])){$m_orderid = (int)$_GET['m_orderid'];}

			// Payment amount that was supposed to be credited to the seller
			if (isset($_GET['m_amount'])){$m_amount = $_GET['m_amount'];}

			// Payment currency
			if (isset($_GET['m_curr'])){$m_curr = $_GET['m_curr'];}

			// m_params will contain data filled in by the Client only if the invoice was created through the payment form created in Azvox
			if (isset($_GET['m_params'])){$m_params = $_GET['m_params'];}

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

			if ($m_orderid > 0){
				// At this point, check if this $m_orderid belongs to the Client who came to this address
				// If everything is correct, show the client a message that the client declined the payment of the invoice
				// Under no circumstances should you mark the order as completed or declined in this script, do this in the StatusUrl script
				echo 'You declined to pay for order number '.$m_orderid.'. Order amount: '.$m_amount.' '.$m_curr;
				exit;
			}
		}
	}
	echo "ERROR";
	exit;
?>

Azvox will send the data to this script when the Client completes or declines the payment.

Keep in mind that the Client does not navigate to this address and does not know its address.

Process the payment, mark it as paid or cancelled, only in this script, and only after appropriate checks.

Be sure to check on your side whether you have previously processed this payment, so as not to credit the purchase again.
In some cases, Azvox may send data multiple times.

StatusUrl must respond with the text $m_orderid|success.
Example: 123|success
Otherwise, Azvox will resend requests periodically until it receives the correct response.
But no more than 10 times.
You can also resend the request from the History section by clicking the More Details button at the right from relevant transaction.

Parameters that Azvox sends to your StatusUrl via POST method

Example of Payment Processing Script - StatusUrl:Copy code
<?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 = "Secret key specified in your site settings";
		$m_shop = "Your site ID in 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
		);

		// Generate signature
		$sign_hash = strtoupper(hash('sha256', implode(':', $arHash)));

		$m_status = $_POST['m_status'];
		$m_shopid = (int)$_POST['m_shop'];
		
		// Verify the signature and other parameters
		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'){
				// The invoice has been paid and you can mark it as paid
				// At this point you need to find the $m_orderid invoice in your accounting system and check
				// does this invoice exist, has it not been processed before, is the payment amount and currency correct
				// If everything is correct, then process it and make the variable $is_all_ok = true
				$is_all_ok = true; // If all your checks are successful and you have processed the invoice, then assign true to the variable
			}elseif ($m_status == 'fail'){
				// The customer refused to pay the invoice. If required, find this invoice in your database and mark that the customer cancelled the invoice
				$is_all_ok = true; // It's similar here. If all your checks are successful and you've processed the invoice, then assign true to the variable
			}
			
			if ($is_all_ok){
				echo $m_orderid.'|success';
				exit;
			}
		}
	}
	echo "ERROR";
	exit;
?>