Документация по API

private const string NumberInvoice = "1";
public static void GetListInvoices()
{
    var requestParams = new Dictionary
    {
        {"Token", AppSettings.Token},
        //Параметры фильтра являются опциональными, по умолчанию возврщает значения за последние 30 дней
        {"AccountNo", NumberInvoice},
        {"From", "20000101" },
        {"To", "21000101" },
        {"Status", "1" }
    };
    var signature = SignatureHelper.Compute(requestParams, string.Empty, "get-list-invoices");
    var url = AppSettings.ServiceUrl + "invoices?token=" + AppSettings.Token + "&signature=" + signature + "&From=20000101&To=21000101&AccountNo=" + NumberInvoice + "&Status=1";
    using (var client = new WebClient())
    {
        client.Encoding = AppSettings.DefaultEncoding;
        var data = client.DownloadString(url);
        Console.WriteLine(data);
    }
}
                    

$baseUrl = "https://api.express-pay.by/v1/";
						
// Отправка GET запроса
function sendRequestGET($url) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
}
						
// Просмотр списка счетов по параметрам
function getListInvoices($token, $fromDate = "", $toDate = "", $status = "", $accountNo = "") {
    global $baseUrl;
    $url = $baseUrl . "invoices?token=" . $token . "&From=" . $fromDate . "&To=" . $toDate . 
	"&AccountNo=" . $accountNo . "&Status=" . $status;
    // Использование цифровой подписи
    // $requestParams = array(
    //     "Token" => $token,
    //     //Параметры фильтра являются опциональными, по умолчанию возвращает значения за последние 30 дней
    //     "AccountNo" => $accountNo,
    //     "From" => $fromDate,
    //     "To" => $toDate,
    //     "Status" => $status
    // );
    // $signature = computeSignature($requestParams, "", "get-list-invoices");
    // $url .= "&signature=" . $signature;
    return sendRequestGET($url); 
}
						
// Пример использования
echo getListInvoices("a75b74cbcfe446509e8ee874f421bd64");
							

public static void AddInvoice()
{
    var requestParams = new Dictionary
    {
        {"Token", AppSettings.Token},
        {"AccountNo", "123456"},
        {"Amount", "10,10"},
        {"Currency", "933"},
        {"Expiration", "20160505"},
        {"Info", "info"},
        {"Surname", "Ivanov"},
        {"FirstName", "Ivan"},
        {"Patronymic", "Ivanovich"},
        {"City", "Minsk"},
        {"Street", "Frunze"},
        {"House", "20"},
        {"Building", "2"},
        {"Apartment", "10"},
        {"IsNameEditable", "0"},
        {"IsAddressEditable", "0"},
        {"IsAmountEditable", "0"},
        {"EmailNotification", "[email protected]"},
        {"SmsPhone", "+375291234567"},
        {"ReturnInvoiceUrl", "1"},
    };
    var signature = SignatureHelper.Compute(requestParams, string.Empty, "add-invoice");
    using (var client = new WebClient())
    {
        var url = AppSettings.ServiceUrl + "invoices?token=" + AppSettings.Token + "&signature=" + signature;
        var response = client.UploadValues(url, new NameValueCollection
        {
            {"AccountNo", "123456"},
            {"Amount", "10,10"},
            {"Currency", "933"},
            {"Expiration", "20160505"},
            {"Info", "info"},
            {"Surname", "Ivanov"},
            {"FirstName", "Ivan"},
            {"Patronymic", "Ivanovich"},
            {"City", "Minsk"},
            {"Street", "Frunze"},
            {"House", "20"},
            {"Building", "2"},
            {"Apartment", "10"},
            {"IsNameEditable", "0"},
            {"IsAddressEditable", "0"},
            {"IsAmountEditable", "0"},                                          
            {"EmailNotification", "[email protected]"},
            {"SmsPhone", "+375291234567"},
            {"ReturnInvoiceUrl", "1"},
        });
        var data = AppSettings.DefaultEncoding.GetString(response);
        Console.WriteLine(data);
    }
}
						

$baseUrl = "https://api.express-pay.by/v1/";
// Отправка POST запроса
function sendRequestPOST($url, $params) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
}
//Выставление счета
function addInvoice($token, $numberAccount, $amount, $currency, $expiration = "", $info = "", 
    $surname = "", $firstName = "", $patronymic = "", $city = "", $street = "", $house="", $building = "", 
	$apartment = "", $isNameEditable = "", $isAddressEditable = "", $isAmountEditable = "", $emailNotification = "", $smsPhone = "", $returnInvoiceUrl = "") {
        global $baseUrl;
	$url = $baseUrl . "invoices?token=" . $token;
    /* Использование цифровой подписи
       $requestParams = array(
            "Token" => $token,
            "AccountNo" => $numberAccount,
            "Amount" => $amount,
            "Currency" => $currency,
            "Expiration" => $expiration,
            "Info" => $info,
            "Surname" => $surname,
            "FirstName" => $firstName,
            "Patronymic" => $patronymic,
            "City" => $city,
            "Street" => $street,
            "House" => $house,
            "Building" => $building,
            "Apartment" => $apartment,
            "IsNameEditable" => $isNameEditable,
            "IsAddressEditable" => $isAddressEditable,
            "IsAmountEditable" => $isAmountEditable,
            "EmailNotification" => $emailNotification,
            "SmsPhone" => $smsPhone,
            "ReturnInvoiceUrl" => $returnInvoiceUrl
	   );
	   $signature = computeSignature($requestParams, "", "add-invoice");
	   $url .= "&signature=" . $signature; */
	$requestParams = array(
            "AccountNo" => $numberAccount,
            "Amount" => $amount,
            "Currency" => $currency,
            "Expiration" => $expiration,
            "Info" => $info,
            "Surname" => $surname,
            "FirstName" => $firstName,
            "Patronymic" => $patronymic,
            "City" => $city,
            "Street" => $street,
            "House" => $house,
            "Building" => $building,
            "Apartment" => $apartment,
            "IsNameEditable" => $isNameEditable,
            "IsAddressEditable" => $isAddressEditable,
            "IsAmountEditable" => $isAmountEditable,
            "EmailNotification" => $emailNotification,
            "SmsPhone" => $smsPhone,
            "ReturnInvoiceUrl" => $returnInvoiceUrl
	);
						
	return sendRequestPOST($url, $requestParams);  
}
						
// Пример использования
echo addInvoice("a75b74cbcfe446509e8ee874f421bd64", 1, "10,10", 933);
						

private const string NumberInvoice = "1";
public static void GetDetailsInvoice()
{
    var requestParams = new Dictionary
    {
        {"Token", AppSettings.Token},
        {"Id", NumberInvoice}
    };
    var signature = SignatureHelper.Compute(requestParams, string.Empty, "get-details-invoice");
    using (var client = new WebClient())
    {
        client.Encoding = AppSettings.DefaultEncoding;
        var data = client.DownloadString(AppSettings.ServiceUrl + "invoices/" + NumberInvoice + "?token=" + AppSettings.Token + "&signature=" + signature);
        Console.WriteLine(data);
    }
}
						

$baseUrl = "https://api.express-pay.by/v1/";
						
// Отправка GET запроса
function sendRequestGET($url) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
}
// Детальная информация о счете
function getDetailsInvoice($numberInvoice, $token) {
    global $baseUrl;
    $url = $baseUrl . "invoices/" . $numberInvoice . "?token=" . $token;
    // Использование цифровой подписи
    // $requestParams = array(
    //     "Token" => $token,
    //     "Id" => $numberInvoice
    // );
    // $signature = computeSignature($requestParams, "", "get-details-invoice");
    // $url .= "&signature=" . $signature;
    return sendRequestGET($url); 
}
						
//Пример использования
getDetailsInvoice(1, "a75b74cbcfe446509e8ee874f421bd64");
						

private const string NumberInvoice = "1";
public static void GetStatusInvoice()
{
    var requestParams = new Dictionary
    {
        {"Token", AppSettings.Token},
        {"Id", NumberInvoice}
    };
    var signature = SignatureHelper.Compute(requestParams, string.Empty, "status-invoice");
    var url = AppSettings.ServiceUrl + "invoices/" + NumberInvoice + "/status?token=" + AppSettings.Token + "&signature=" + signature;
    using (var client = new WebClient())
    {
        client.Encoding = AppSettings.DefaultEncoding;
        var data = client.DownloadString(url);
        Console.WriteLine(data);
    }
}
							

$baseUrl = "https://api.express-pay.by/v1/";
// Отправка GET запроса
function sendRequestGET($url) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
}
						
// Статус счета
function getStatusInvoice($numberInvoice, $token) {
    global $baseUrl;
    $url = $baseUrl . "invoices/" . $numberInvoice . "/status?token=" . $token;
    // Использование цифровой подписи
    // $requestParams = array(
    //     "Token" => $token,
    //     "Id" => $numberInvoice
    // );
    // $signature = computeSignature($requestParams, "", "status-invoice");
    // $url .= "&signature=" . $signature;
    return sendRequestGET($url);
}
						
//Пример использования
echo getStatusInvoice(1, "a75b74cbcfe446509e8ee874f421bd64");
							

private const string NumberInvoice = "1";
public static void CancelInvoice()
{
    var requestParams = new Dictionary
    {
        {"Token", AppSettings.Token},
        {"Id", NumberInvoice}
    };
    var signature = SignatureHelper.Compute(requestParams, string.Empty, "cancel-invoice");
    var url = AppSettings.ServiceUrl + "invoices/" + NumberInvoice + "?token=" + AppSettings.Token + "&signature=" + signature;
    using (var client = new WebClient())
    {
        client.Encoding = AppSettings.DefaultEncoding;
        var data = client.UploadString(url, "DELETE", string.Empty);
        Console.WriteLine(data);
    }
}
						

$baseUrl = "https://api.express-pay.by/v1/";
// Отправка DELETE запроса
function sendRequestDELETE($url) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
}
// Отменить счет
function cancelInvoice($numberInvoice, $token) {
    global $baseUrl;
    $url = $baseUrl . "invoices/" . $numberInvoice . "?token=" . $token;
    // Использование цифровой подписи
    // $requestParams = array(
    //     "Token" => $token,
    //     "Id" => $numberInvoice
    // );
    // $signature = computeSignature($requestParams, "", "cancel-invoice");
    // $url .= "&signature=" . $signature;
    return sendRequestDELETE($url); 
}
//Пример использования
echo cancelInvoice(1, "a75b74cbcfe446509e8ee874f421bd64");
						

private const string NumberPayment = "1022";
public static void GetDetailsPayment()
{
    var requestParams = new Dictionary
    {
        {"Token", AppSettings.Token},
        {"InvoiceId", NumberPayment},
        {"ViewType", ViewType},
        {"ImageWidth", ImageWidth},
        {"ImageHeight", ImageHeight},

    };
    var signature = SignatureHelper.Compute(requestParams, string.Empty, "get-qr-code");
    using (var client = new WebClient())
    {
        client.Encoding = AppSettings.DefaultEncoding;
        string downloadString = string.Format("{0}qrcode/getqrcode/?token={1}&invoiceid={2}{3}{4}{5}",);
                                              AppSettings.ServiceUrl,requestParams["Token"], requestParams["InvoiceId"],
                                              string.IsNullOrEmpty(requestParams["ViewType"]) ? string.Empty : requestParams["ViewType"],
                                              requestParams["ImageWidth"] == null ? string.Empty : requestParams["ImageWidth"],
                                              requestParams["ImageHeight"] == null ? string.Empty : requestParams["ImageHeight"],
        var data = client.DownloadString(downloadString);
        Console.WriteLine(data);
    }
}
							

private static $baseUrl = "https://api.express-pay.by/v1/";
// Отправка GET запроса
private static function sendRequestGET($url) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
}
// Генерация QR-кода
function getQrCode($token, $invoiceId) {
    global $baseUrl;
    $url = $baseUrl . "qrcode/getqrcode/?token=" . $token . '&invoiceid=' . $invoiceId;
    // Использование цифровой подписи
    // $requestParams = array(
    //     "token" => $token,
    //     "invoiceid" => $invoiceId
    // );
    // $signature = computeSignature($requestParams, "", "get-qr-code");
    // $url .= "&signature=" . $signature;
    return sendRequestGET($url); 
}  
//Пример использования					
echo getQrCode("a75b74cbcfe446509e8ee874f421bd64", 1);
					

public static void AddCardInvoice()
{
    var requestParams = new Dictionary
    {
        {"Token", AppSettings.Token},
        {"AccountNo", "123456"},
        {"Expiration", "20161224"},
        {"Amount", "10,10"},
        {"Currency", "933"},
        {"Info", "info"},
        {"ReturnUrl", "https://example.com/success"},
        {"FailUrl", "https://example.com/fail"},
        {"Language", "ru"},
        {"SessionTimeoutSecs", "1200"},
        {"ExpirationDate", "20161224235001"},
        {"ReturnInvoiceUrl", "1"},
    };
    var signature = SignatureHelper.Compute(requestParams, string.Empty, "add-card-invoice");
    using (var client = new WebClient())
    {
        var url = AppSettings.ServiceUrl + "cardinvoices?token=" + AppSettings.Token + "&signature=" + signature;
        var response = client.UploadValues(url, new NameValueCollection
        {
            {"AccountNo", "123456"},
            {"Expiration", "20161224"},
            {"Amount", "10,10"},
            {"Currency", "933"},
            {"Info", "info"},
            {"ReturnUrl", "https://example.com/success"},
            {"FailUrl", "https://example.com/fail"},
            {"Language", "ru"},
            {"SessionTimeoutSecs", 1200},
            {"ExpirationDate", "20161224235001"},
            {"ReturnInvoiceUrl", "1"},
        });
        var data = AppSettings.DefaultEncoding.GetString(response);
        Console.WriteLine(data);
    }
}
							

$baseUrl = "https://api.express-pay.by/v1/";
// Отправка POST запроса
function sendRequestPOST($url, $params) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
}
//Выставление счета по карте
function addInvoiceByCard($token, $accountNo, $amount, $currency, $info, $returnUrl, $failUrl, $expiration="", $language="", $pageView="", $sessionTimeoutSecs="", $expirationDate="", $returnInvoiceUrl = "") {
        global $baseUrl;
	$url = $baseUrl . "cardinvoices?token=" . $token;
	/*$requestParams = array(
            "Token" => $token,
            "AccountNo" => $accountNo,
            "Expiration" => $expiration,
            "Amount" => $amount,
            "Currency" => $currency,
            "Info" => $info,
            "ReturnUrl" => $returnUrl,
            "FailUrl" => $failUrl,
            "Language" => $language,
            "SessionTimeoutSecs" => $sessionTimeoutSecs,
            "ExpirationDate" => $expirationDate,
            "ReturnInvoiceUrl" => $returnInvoiceUrl
	);*/
						
	// Использование цифровой подписи
	// $signature = computeSignature($requestParams, "", "add-card-invoice");
	// $url .= "&signature=" . $signature;
    
    $requestParams = array(
            "AccountNo" => $accountNo,
            "Expiration" => $expiration,
            "Amount" => $amount,
            "Currency" => $currency,
            "Info" => $info,
            "ReturnUrl" => $returnUrl,
            "FailUrl" => $failUrl,
            "Language" => $language,
            "SessionTimeoutSecs" => $sessionTimeoutSecs,
            "ExpirationDate" => $expirationDate,
            "ReturnInvoiceUrl" => $returnInvoiceUrl
	);
    
	return sendRequestPOST($url, $requestParams);  
}
						
// Пример использования
echo addInvoiceByCard("a75b74cbcfe446509e8ee874f421bd64", "123456", "10,10", 933, "info", "https://example.com/success", "https://example.com/fail","20161224", "ru", 1200, "20161224235001");
					

private const string CardNumberInvoice = "100";
public static void PaymentCardInvoice()
{
    var requestParams = new Dictionary
    {
        {"Token", AppSettings.Token},
        {"CardInvoiceNo", CardNumberInvoice},
    };
    var signature = SignatureHelper.Compute(requestParams, string.Empty, "card-invoice-form");        
    var url = AppSettings.ServiceUrl + "cardinvoices/" + CardNumberInvoice + "/payment?token="+AppSettings.Token+"&signature="+signature;
    using (var client = new WebClient())
    {
        client.Encoding = AppSettings.DefaultEncoding;
        var data = client.DownloadString(url);
        Console.WriteLine(data);
    }
}
							

private static $baseUrl = "https://api.express-pay.by/v1/";
// Отправка GET запроса
private static function sendRequestGET($url) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
}
// Форма оплаты
function getPaymentForm($token, $cardNumberInvoice) {
    global $baseUrl;
    $url = $baseUrl . "cardinvoices/" . $cardNumberInvoice . "/payment?token=" . $token;
    // Использование цифровой подписи
    // $requestParams = array(
    //     "Token" => $token,
    //     "CardInvoiceNo" => $cardNumberInvoice
    // );
    // $signature = computeSignature($requestParams, "", "card-invoice-form");
    // $url .= "&signature=" . $signature;
    return sendRequestGET($url); 
}  
//Пример использования					
echo getPaymentForm("a75b74cbcfe446509e8ee874f421bd64","100");
					

                             
private const string CardNumberInvoice = "1674";
public static void StatusCardInvoice()
{
    var requestParams = new Dictionary
    {
        {"Token", AppSettings.Token},
        {"CardInvoiceNo", CardNumberInvoice},
        {"Language", "ru"},
    };
    var signature = SignatureHelper.Compute(requestParams, string.Empty, "status-card-invoice");
    var url = AppSettings.ServiceUrl + "cardinvoices/" + CardNumberInvoice + "/status?token=" + AppSettings.Token + "&signature=" + signature + "&language=ru";
    using (var client = new WebClient())
    {
        client.Encoding = AppSettings.DefaultEncoding;
        var data = client.DownloadString(url);
        Console.WriteLine(data);
    }
}
							

private static $baseUrl = "https://api.express-pay.by/v1/";
// Отправка GET запроса
private static function sendRequestGET($url) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
}
// Статус счета по карте
function getStatusCardInvoice($token, $InvoiceId, $language="") {
    global $baseUrl;
    $url = $baseUrl . "cardinvoices/" . $InvoiceId . "/status?token=" . $token;
    // Использование цифровой подписи
    // $requestParams = array(
    //     "Token" => $token,
    //     "CardInvoiceNo" => $InvoiceId,
    //     "Language" => "ru"
    // );
    // $signature = computeSignature($requestParams, "", "status-card-invoice");
    // $url .= "&signature=" . $signature;
    return sendRequestGET($url); 
}  
//Пример использования					
echo getStatusCardInvoice("a75b74cbcfe446509e8ee874f421bd64", "1674");
					

                             
private const string CardNumberInvoice = "1674";
public static void ReverseCardInvoice()
{
    var requestParams = new Dictionary
    {
        {"Token", AppSettings.Token},
        {"CardInvoiceNo", CardNumberInvoice}
    };
    var signature = SignatureHelper.Compute(requestParams, string.Empty, "reverse-card-invoice");

    var url = AppSettings.ServiceUrl + "cardinvoices/" + CardNumberInvoice + "/reverse?token=" + AppSettings.Token + "&signature=" + signature;

    using (var client = new WebClient())
    {
        client.Encoding = AppSettings.DefaultEncoding;
		var response = client.UploadValues(url, new NameValueCollection());
		var data = AppSettings.DefaultEncoding(response);
        Console.WriteLine(data);
    }
}
							

                             
$baseUrl = "https://api.express-pay.by/v1/";
// Отправка POST запроса
function sendRequestPOST($url, $params) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
}
// Отмена счета по карте
function reverseCardInvoice($token, $invoiceId) {
    global $baseUrl;
    $url = $baseUrl . "cardinvoices/" . $invoiceId . "/reverse?token=" . $token;
    $requestParams = array(
        "Token" => $token,
        "CardInvoiceNo" => $invoiceId
    );
    // Использование цифровой подписи
    // $signature = computeSignature($requestParams, "", "reverse-card-invoice");
    // $url .= "&signature=" . $signature;
    return sendRequestPOST($url, $requestParams); 
}  
//Пример использования					
echo reverseCardInvoice("a75b74cbcfe446509e8ee874f421bd64", "1674");
					

                    
                            
private static string SiteUrl = "http://localhost/";

public static void AddWebInvoice()
{
    var requestParams = new Dictionary
    {
        {"Token", AppSettings.Token},
        {"ServiceId", AppSettings.ServiceId},
        {"AccountNo", "123456"},
        {"Amount", "10"},
        {"Currency", "974"},
        {"Expiration", "20160505"},
        {"Info", "info"},
        {"Surname", "Ivanov"},
        {"FirstName", "Ivan"},
        {"Patronymic", "Ivanovich"},
        {"City", "Minsk"},
        {"Street", "Frunze"},
        {"Building", "2"},
        {"Apartment", "10"},
        {"IsNameEditable", "0"},
        {"IsAddressEditable", "0"},
        {"IsAmountEditable", "0"},
        {"EmailNotification", "[email protected]"},
        {"SmsPhone", "+375291234567"},
        {"ReturnType","redirect"},
        {"ReturnUrl",this.SiteUrl  + "success"},
        {"FailUrl",this.SiteUrl  + "fail"},
        {"ReturnInvoiceUrl", "1"},
    };

    var signature = SignatureHelper.Compute(requestParams, string.Empty, "add-web-invoice");

    using (var client = new WebClient())
    {
        var url = AppSettings.ServiceUrl;
        var response = client.UploadValues(url, new NameValueCollection
        {
            {"ServiceId", AppSettings.ServiceId},
            {"AccountNo", "123456"},
            {"Amount", "10"},
            {"Currency", "974"},
            {"Expiration", "20160505"},
            {"Info", "info"},
            {"Surname", "Ivanov"},
            {"FirstName", "Ivan"},
            {"Patronymic", "Ivanovich"},
            {"City", "Minsk"},
            {"Street", "Frunze"},
            {"Building", "2"},
            {"Apartment", "10"},
            {"IsNameEditable", "0"},
            {"IsAddressEditable", "0"},
            {"IsAmountEditable", "0"},
            {"EmailNotification", "[email protected]"},
            {"SmsPhone", "+375291234567"},
            {"ReturnType", "redirect"},
            {"ReturnUrl",this.SiteUrl  + "success"},
            {"FailUrl",this.SiteUrl  + "fail"},
            {"Signature", signature},
            {"ReturnInvoiceUrl", "1"},
        });

        var data = AppSettings.DefaultEncoding.GetString(response);
        Console.WriteLine(data);
    }
}

                        
                    

                        
$baseUrl = "https://sandbox-api.express-pay.by/v1/";

// Отправка POST запроса
function sendRequestPOST($url, $params) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);

    return $response;
}

// Выставление счета
function addWebInvoice($token, $serviceId, $numberAccount, $amount, $currency, $returnType, $returnUrl = "", $failUrl = "", $expiration = "", $info = "", $surname = "", $firstName = "", $patronymic = "", $city = "", $street = "", $building = "", $apartment = "", $isNameEditable = "",  $isAddressEditable = "", $isAmountEditable = "", $emailNotification = "", $smsPhone = "", $returnInvoiceUrl = "") {
    
    $url = $baseUrl . "web_invoices";

    $requestParams = array(
            "ServiceId" => $serviceId,
            "AccountNo" => $numberAccount,
            "Amount" => $amount,
            "Currency" => $currency,
            "Expiration" => $expiration,
            "Info" => $info,
            "Surname" => $surname,
            "FirstName" => $firstName,
            "Patronymic" => $patronymic,
            "City" => $city,
            "Street" => $street,
            "Building" => $building,
            "Apartment" => $apartment,
            "IsNameEditable" => $isNameEditable,
            "IsAddressEditable" => $isAddressEditable,
            "IsAmountEditable" => $isAmountEditable,
            "EmailNotification" => $emailNotification,
            "SmsPhone" => $smsPhone,
            "ReturnType" => $returnType,
            "ReturnUrl" => $returnUrl,
            "FailUrl" => $failUrl,
            "ReturnInvoiceUrl" => $returnInvoiceUrl
    );

    // Использование цифровой подписи
    $signature = computeWebSignature($token, $requestParams, "", "add-web-invoice");
  $requestParams["Signature"] = $signature;
    return sendRequestPOST($url, $requestParams);  
}

// Пример запуска
echo addInvoice("a75b74cbcfe446509e8ee874f421bd64",1, 1, 10, 933, "json");
                        
                    

                    
                            
public static void AddWebCardInvoice()
{
    var requestParams = new Dictionary
    {
        {"Token", AppSettings.Token},
        {"ServiceId", AppSettings.ServiceId},
        {"AccountNo", "123456"},
        {"Expiration", "20161224"},
        {"Amount", "10"},
        {"Currency", "933"},
        {"Info", "info"},
        {"ReturnUrl", "https://example.com/success"},
        {"FailUrl", "https://example.com/fail"},
        {"Language", "ru"},
        {"SessionTimeoutSecs", "1200"},
        {"ExpirationDate", "20161224235001"},
        {"ReturnInvoiceUrl", "1"},
    };
    var signature = SignatureHelper.Compute(requestParams, string.Empty, "add-webcard-invoice");
    using (var client = new WebClient())
    {
        var url = AppSettings.ServiceUrl;
        var response = client.UploadValues(url, new NameValueCollection
        {
            {"ServiceId", AppSettings.ServiceId},
            {"AccountNo", "123456"},
            {"Expiration", "20161224"},
            {"Amount", "10"},
            {"Currency", "933"},
            {"Info", "info"},
            {"ReturnUrl", "https://example.com/success"},
            {"FailUrl", "https://example.com/fail"},
            {"Language", "ru"},
            {"SessionTimeoutSecs", 1200},
            {"ExpirationDate", "20161224235001"},
            {"Signature", signature},
            {"ReturnInvoiceUrl", "1"},
        });
        var data = AppSettings.DefaultEncoding.GetString(response);
        Console.WriteLine(data);
    }
}
                        
                    

                    
$baseUrl = "https://api.express-pay.by/v1/";

// Отправка POST запроса
function sendRequestPOST($url, $params) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
}
//Выставление счета по карте
function addInvoiceByCard($token, $serviceId, $accountNo, $amount, $currency, $info, $returnUrl, $failUrl, $expiration="", $language="", $pageView="", $sessionTimeoutSecs="", $expirationDate="", $returnInvoiceUrl = "") {
       $url = $baseUrl . "webcardinvoices";
    $requestParams = array(
            "ServiceId" => $serviceId,
            "AccountNo" => $accountNo,
            "Expiration" => $expiration,
            "Amount" => $amount,
            "Currency" => $currency,
            "Info" => $info,
            "ReturnUrl" => $returnUrl,
            "FailUrl" => $failUrl,
            "Language" => $language,
            "SessionTimeoutSecs" => $sessionTimeoutSecs,
            "ExpirationDate" => $expirationDate,
            "ReturnInvoiceUrl" => $returnInvoiceUrl
    );
                        
    // Использование цифровой подписи
     $signature = computeWebSignature($token,$requestParams, "", "add-card-invoice");
     $url .= "&signature=" . $signature;
    return sendRequestPOST($url, $requestParams);  
}
                        
// Пример использования
echo addInvoiceByCard("a75b74cbcfe446509e8ee874f421bd64", 1,"123456", "20161224", 10, 933, "info", "https://example.com/success", "https://example.com/fail", "ru", 1200, "20161224235001");
                        
                    

private const string NumberPayment = "1022";
public static void GetListPayments()
{
    var requestParams = new Dictionary
    {
        {"Token", AppSettings.Token},
        // Параметры фильтра являются опциональными. По умолчанию возвращает значения за последние 30 дней
        {"AccountNo", NumberPayment},
        {"From", "20000101" },
        {"To", "21000101" }
    };
    var signature = SignatureHelper.Compute(requestParams, string.Empty, "get-list-payments");
    var url = AppSettings.ServiceUrl + "payments?token=" + AppSettings.Token + "&signature=" + signature + "&From=20000101&To=21000101&AccountNo=" + NumberPayment;
    using (var client = new WebClient())
    {
        client.Encoding = AppSettings.DefaultEncoding;
        var data = client.DownloadString(url);
        Console.WriteLine(data);
    }
}
					

private static $baseUrl = "https://api.express-pay.by/v1/";
// Отправка GET запроса
private static function sendRequestGET($url) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
}
// Получить список оплат
public static function getListPayments($token, $fromDate = "", $toDate = "", $numberPayment = "") {
    global $baseUrl;
    $url = $baseUrl . "payments?token=" . $token;
    // Использование цифровой подписи
    // $requestParams = array(
    //     "Token" => $token,
    //      //Параметры фильтра являются опциональными, по умолчанию возвращает значения за последние 30 дней
    //      "AccountNo" => $numberPayment,
    //      "From" => $fromDate,
    //      "To" => $toDate,
    // );
    // $signature = computeSignature($requestParams, "", "get-list-payments");
    // $url .= "&signature=" . $signature;
    return sendRequestGET($url); 
}
						
//Пример использования
echo getListPayments("a75b74cbcfe446509e8ee874f421bd64");
					

private const string NumberPayment = "1022";
public static void GetDetailsPayment()
{
    var requestParams = new Dictionary
    {
        {"Token", AppSettings.Token},
        {"Id", NumberPayment}
    };
    var signature = SignatureHelper.Compute(requestParams, string.Empty, "get-details-payment");
    using (var client = new WebClient())
    {
        client.Encoding = AppSettings.DefaultEncoding;
        var data = client.DownloadString(AppSettings.ServiceUrl + "payments/" + NumberPayment + "?token=" + AppSettings.Token + "&signature=" + signature);
        Console.WriteLine(data);
    }
}
							

private static $baseUrl = "https://api.express-pay.by/v1/";
// Отправка GET запроса
private static function sendRequestGET($url) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
}
// Детальная информация об оплате
function getDetailPayment($token, $numberPayment) {
    global $baseUrl;
    $url = $baseUrl . "payments/" . $numberPayment . "?token=" . $token;
    // Использование цифровой подписи
    // $requestParams = array(
    //     "Token" => $token,
    //     "Id" => $numberPayment
    // );
    // $signature = computeSignature($requestParams, "", "get-details-payment");
    // $url .= "&signature=" . $signature;
    return sendRequestGET($url); 
}  
//Пример использования					
echo getDetailPayment("a75b74cbcfe446509e8ee874f421bd64", 1);
					

private const string AccountNo = "1022";
public static void GetBalance()
{
    var requestParams = new Dictionary
    {
        {"Token", AppSettings.Token},
        {"AccountNo", AccountNo}
    };
    var signature = SignatureHelper.Compute(requestParams, string.Empty, "balance");
    var url = AppSettings.ServiceUrl + "balance?token=" + AppSettings.Token + "&signature=" + signature + "&accountno=" + AccountNo;
    using (var client = new WebClient())
    {
        client.Encoding = AppSettings.DefaultEncoding;
        var data = client.DownloadString(url);
        Console.WriteLine(data);
    }
}
                

    private static $baseUrl = "https://api.express-pay.by/v1/";
    // Отправка GET запроса
    private static function sendRequestGET($url) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
    }
    // Получить баланс по лицевому счету
    public static function getBalnce($token, $accountNo) {
    global $baseUrl;
    $url = $baseUrl . "balance?token=" . $token . "&accountno=" . $accountNo;
    // Использование цифровой подписи
    // $requestParams = array(
    //     "Token" => $token,
    //      "AccountNo" => $accountNo,
    // );
    // $signature = computeSignature($requestParams, "", "balance");
    // $url .= "&signature=" . $signature;
    return sendRequestGET($url);
    }

    //Пример использования
    echo getBalnce("a75b74cbcfe446509e8ee874f421bd64", "123");

namespace EripNotify.Models
{
    public class EripNotify
    {
        public string Data { get; set; }
        public string Signature { get; set; }
    }
}
namespace EripNotify.Controllers
{
    public class EripNotifyController : ApiController
    {
        private static readonly Encoding HashEncoding = Encoding.UTF8;
        private string _secretWord = "secretWord";
        private bool _useSignature = false;
        [HttpPost]
        public IHttpActionResult Test(Models.EripNotify model)
        {
            if (_useSignature)
            {
                // Проверяем цифровую подпись
                if (model.Signature != ComputeSignature(model.Data, _secretWord))
                {
                    // NOTE: Добавить обработку ошибки
                    // ...
                    return InternalServerError();
                }
            }
            // Преобразуем из JSON в Object
            var obj = JObject.Parse(model.Data);
            // NOTE: Выполняем действия с полученным объектом
            // ...
            return Ok();
        }
        // Функция генерации и проверки цифровой подписи
        public string ComputeSignature(string json, string secretWord)
        {
            var hmac = string.IsNullOrWhiteSpace(secretWord) ? 
                new HMACSHA1(HashEncoding.GetBytes(string.Empty)) : 
                new HMACSHA1(HashEncoding.GetBytes(secretWord));
            var hash = hmac.ComputeHash(HashEncoding.GetBytes(json));
            var result = new StringBuilder();
            foreach (var item in hash)
                result.Append(item.ToString("X2"));
            return result.ToString();
        }
    }
}

// Секретное слово указывается в настройках личного кабинета
$secretWord = "secretWord";
// Использование цифровой подписи указывается в настройках личного кабинета
$isUseSignature = true;
// Обработка POST запроса
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
	$data = $_POST['Data'];
	$signature = $_POST['Signature'];
    
        // Проверяем использование цифровой подписи
        if($isUseSignature) {
            // Проверяем цифровую подпись
    	    if($signature == computeSignature($data, $secretWord)) {
                // Преобразуем из JSON в Object
	        $data = json_decode($data);
	        // NOTE: Добавить обработку данных о полученном платеже
	        // ...
                echo "success";
	    } else {
	    	echo "fail signature";
	    }
    } else { 
        // Без использования цифровой подписи
    	// Преобразуем из JSON в Object
        $data = json_decode($data);
    	
        // NOTE: Добавить обработку данных о полученном платеже
        // ...
       	echo "success";
    }
}
// Функция генерации и проверки цифровой подписи
function computeSignature($json, $secretWord) {
    $hash = NULL;
    
    if (empty(trim($secretWord)))
	$hash = strtoupper(hash_hmac('sha1', $json, ""));
    else
        $hash = strtoupper(hash_hmac('sha1', $json, $secretWord));
    return $hash;
}

namespace ExPay.Api
{
    public static class AppSettings
    {
        public const string ServiceUrl = "https://api.express-pay.by/v1/";
        public const string Token = "a75b74cbcfe446509e8ee874f421bd63"; // API-ключ
        public static readonly Encoding DefaultEncoding = Encoding.UTF8;
    }
    public static class SignatureHelper
    {
        private static readonly Encoding HashEncoding = Encoding.UTF8;
        // Порядок следования полей при вычислении цифровой подписи.
        // Внимание! Для корректной работы порядок изменять нельзя
        private static readonly Dictionary Mapping = new Dictionary
        {
            {
                "add-invoice", new[]
                {
                    "token",
                    "accountno",
                    "amount",
                    "currency",
                    "expiration",
                    "info",
                    "surname",
                    "firstname",
                    "patronymic",
                    "city",
                    "street",
                    "house",
                    "building",
                    "apartment",
                    "isnameeditable",
                    "isaddresseditable",
                    "isamounteditable",
                    "emailnotification",
                    "returninvoiceurl"
                }
            },
            {
                "get-details-invoice", new[]
                {
                    "token",
                    "id"
                }
            },
            {
                "cancel-invoice", new[]
                {
                    "token",
                    "id"
                }
            },
            {
                "status-invoice", new[]
                {
                    "token",
                    "id"
                }
            },
            {
                "get-list-invoices", new[]
                {
                    "token",
                    "from",
                    "to",
                    "accountno",
                    "status"
                }
            },
            {
                "get-list-payments", new[]
                {
                    "token",
                    "from",
                    "to",
                    "accountno"
                }
            },
            {
                "get-details-payment", new[]
                {
                    "token",
                    "id"
                }
            },
            {
                "balance", new[]
                {
                    "token",
                    "accountno"
                }
            },
            {
                "add-card-invoice", new[]
                {
                    "token",
                    "accountno",                 
                    "expiration",             
                    "amount",                  
                    "currency",
                    "info",      
                    "returnurl",
                    "failurl",
                    "language",
                    "pageview",
                    "sessiontimeoutsecs",
                    "expirationdate"
                }
            },
            {
                "card-invoice-form", new[]
                {
                    "token",
                    "CardInvoiceNo"
                }
            },
            {
                "status-card-invoice", new[]
                {
                    "token",
                    "CardInvoiceNo",
                    "language"
                }
            },
            {
                "reverse-card-invoice", new[]
                {
                    "token",
                    "CardInvoiceNo"
                }
            },
            {
                "get-qr-code", new[]
                {
                    "token",
                    "invoiceid",
                    "viewtype",
                    "imagewidth",
                    "imageheight"
                }
            },
            {
                "add-web-invoice",new[]
                {
                    "token",
                    "serviceid",
                    "accountno",
                    "amount",   
                    "currency",
                    "expiration",
                    "info",
                    "surname",
                    "firstname",
                    "patronymic",
                    "city",
                    "street",
                    "house",
                    "building",
                    "apartment",
                    "isnameeditable",
                    "isaddresseditable",
                    "isamounteditable",
                    "emailnotification",
                    "smsphone",
                    "returntype",
                    "returnurl",
                    "failurl",
                    "returninvoiceurl"
                }
            },
            {
                "add-webcard-invoice",new[]
                {
                    "token",
                    "serviceid",
                    "accountno",
                    "expiration",   
                    "amount",
                    "currency",
                    "info",
                    "returnurl",
                    "failurl",
                    "language",
                    "sessiontimeoutsecs",
                    "expirationdate",
                    "returntype",
                    "returninvoiceurl"
                }
            }

        };
        public static string Compute(Dictionary requestParams, string secretWord, string action)
        {
            var normalizedParams = requestParams
                .ToDictionary(k => k.Key.ToLower(), v => v.Value);
            var cmdFields = Mapping[action];
            var builder = new StringBuilder();
            foreach (var cmdField in cmdFields)
            {
                if (normalizedParams.ContainsKey(cmdField))
                    builder.Append(normalizedParams[cmdField]);
            }
            HMACSHA1 hmac;
            if (string.IsNullOrWhiteSpace(secretWord))
            {
                // В алгоритме всегда должно быть задан ключ шифрования. Если используется конструктор по умолчанию, то ключ генерируется автоматически,
                // что нам не подходит
                hmac = new HMACSHA1(HashEncoding.GetBytes(string.Empty));
            }
            else
            {
                hmac = new HMACSHA1(HashEncoding.GetBytes(secretWord));
            }
            var hash = hmac.ComputeHash(
                HashEncoding.GetBytes(builder.ToString()));
            var result = new StringBuilder();
            foreach (var item in hash)
            {
                result.Append(item.ToString("X2"));
            }
            return result.ToString();
        }
    }
}
						

// Формирование цифровой подписи
function computeSignature($requestParams, $secretWord, $method) {
    $normalizedParams = array_change_key_case($requestParams, CASE_LOWER);
    $mapping = array(
        "add-invoice" => array(
                                "token",
                                "accountno",
                                "amount",
                                "currency",
                                "expiration",
                                "info",
                                "surname",
                                "firstname",
                                "patronymic",
                                "city",
                                "street",
                                "house",
                                "building",
                                "apartment",
                                "isnameeditable",
                                "isaddresseditable",
                                "isamounteditable",
                                "emailnotification",
                                "returninvoiceurl"),
        "get-details-invoice" => array(
                                "token",
                                "id"),
        "cancel-invoice" => array(
                                "token",
                                "id"),
        "status-invoice" => array(
                                "token",
                                "id"),
        "get-list-invoices" => array(
                                "token",
                                "from",
                                "to",
                                "accountno",
                                "status"),
        "get-list-payments" => array(
                                "token",
                                "from",
                                "to",
                                "accountno"),
        "get-details-payment" => array(
                                "token",
                                "id"),
        "add-card-invoice"  =>  array(
                                "token",
                                "accountno",                 
                                "expiration",             
                                "amount",                  
                                "currency",
                                "info",      
                                "returnurl",
                                "failurl",
                                "language",
                                "pageview",
                                "sessiontimeoutsecs",
                                "expirationdate"),
       "card-invoice-form"  =>  array(
                                "token",
                                "CardInvoiceNo"),
        "status-card-invoice" => array(
                                "token",
                                "CardInvoiceNo",
                                "language"),
        "reverse-card-invoice" => array(
                                "token",
                                "CardInvoiceNo"),
        "get-qr-code"          => array(
                                 "token",
                                 "invoiceid",
                                 "viewtype",
                                 "imagewidth",
                                 "imageheight"),
        "add-web-invoice"      => array(
                                "token",
                                "serviceid",
                                "accountno",
                                "amount",
                                "currency",
                                "expiration",
                                "info",
                                "surname",
                                "firstname",
                                "patronymic",
                                "city",
                                "street",
                                "house",
                                "building",
                                "apartment",
                                "isnameeditable",
                                "isaddresseditable",
                                "isamounteditable",
                                "emailnotification",
                                "smsphone",
                                "returntype",
                                "returnurl",
                                "failurl",
                                "returninvoiceurl"),
        "add-webcard-invoice" => array(
                                 "token",
                                "serviceid",
                                "accountno",
                                "expiration",
                                "amount",
                                "currency",
                                "info",
                                "returnurl",
                                "failurl",
                                "language",
                                "sessiontimeoutsecs",
                                "expirationdate",
                                "returntype",
                                "returninvoiceurl")
    );
    $apiMethod = $mapping[$method];
    $result = "";
    foreach ($apiMethod as $item){
        $result .= $normalizedParams[$item];
    }
    $hash = strtoupper(hash_hmac('sha1', $result, $secretWord));
    return $hash;
}
						

Система ЕРИП

Тестовые счета на оплату

Тестовые платежи

Интернет-эквайринг

Тестовые счета на оплату банковской картой

Система E-POS

Тестовые счета на оплату