Наименование параметра | Описание | Допустимые символы | Минимальное, максимальное кол–во знаков | Допустимые значения | Обязателен | Пример |
---|---|---|---|---|---|---|
project_id | Идентификатор проекта; указан в настройках Проекта | [a-zA-Z0-9] | 32, 32 | Любые | Да | 0D2239F1BBDAA3E4F98CFD0CDF2F9D73 |
amount | Сумма к оплате. Разделитель – точка (.). Обязательно всегда указывать два знака после разделителя. | [0-9.] | 1,10 | Минимальное – 1.15, максимальное: – 1000000 RUB – 10000 USD |
Да | 95.25 |
currency_code | Код валюты оплаты. Прием RUB только с карт, выпущенных банками РФ. Прием USD только с зарубежных карт и по предварительному согласованию проекта. |
– | – | RUB, USD | Да | RUB |
manual_confirmation | Необходимость заморозки средств на карте. В случае включения данной опции, средства на карте будут первоначально заморожены (заблокированы/холдированы), списание произойдет автоматически на 7-ой день или ранее, если Вы вручную выполните операцию подтверждения через интерфейс карточки транзакции в Личном Кабинете. Данная опция (значение 1) доступна только по предварительному согласованию для проекта. Данная опция (значение 1) недоступна для оплаты в USD. |
– | – | 0, 1 | Да | 0 |
description | Назначение платежа. Отображается на странице оплаты | [a-zA-Z0-9-+()*\/#.,:;а-яА-Я ] | 5, 300 | Любые | Да | Оплата услуги А |
language | Код языка интерфейса страницы оплаты по–умолчанию, допускается русский (ru-RU) и английский (en-US) | – | – | ru-RU, en-US | Да | ru-RU |
reference_1 | Произвольные данные для отслеживания транзакции. Эти данные не отображаются на странице оплаты, но доступны для просмотра Вам в карточке транзакции в Личном Кабинете, при экспорте транзакций в CSV, при просмотре транзакции через API и в обратном вызове (вебхуке) | [a-zA-Z0-9 ] | 0, 32 | Любые | Нет | Customer 1 |
reference_2 | Дополнительные произвольные данные для отслеживания транзакции, как reference_1 | [a-zA-Z0-9 ] | 0, 32 | Любые | Нет | Invoice 1 |
reference_3 | Дополнительные произвольные данные для отслеживания транзакции, как reference_1 | [a-zA-Z0-9 ] | 0, 32 | Любые | Нет | Account 1 |
success_url | В случае успешной оплаты, происходит перенаправление на указанный адрес. На этой странице Вы можете указать информацию по сборке заказа, подтверждение, что заказ принят в работу и т.п. В случае если значение адреса перенаправления не задано, то используется стандартная страница Сервиса | Значение URL должно быть передано в зашифрованном виде, по стандарту Base64. Допустимые символы в изначальном значении URL [a-zA-Z0-9-\/._:=?&;] Изначальное значение URL должно начинаться с http:// или https:// Допустимые символы в зашифрованном URL [a-zA-Z0-9=] |
Максимальное в изначальном значении URL – 300 | Любые | Нет | aHR0cHM6Ly9leGFtcGxlLmNvbS9wYXltZW50X3N1Y2Nlc3M= |
signature | Значение подписи составляется на основе значений нескольких вышеуказанных параметров (см. ниже) | [a-zA-Z0-9] | 32, 32 | Любые | Да | 6D2239F1BZDAA3E4F98CFD0CDF2F9D18 |
$project_id='0D2239F1BBDAA3E4F98CFD0CDF2F9D73';
$amount='95.25';
$currency_code='RUB';
$manual_confirmation='0';
$description='Оплата услуги А';
$reference_1='Customer 1';
$reference_2='Invoice 1';
$reference_3='Account 1';
$api_key='1EA457132ABC39FBBA99A0EEFE0BF13D';
$signature=md5("$project_id, $amount, $currency_code, $manual_confirmation, $description, $reference_1, $reference_2, $reference_3, $api_key");
//значение подписи 62849e666a6d4ea616a97e704be4c5ec
$project_id='0D2239F1BBDAA3E4F98CFD0CDF2F9D73';
$amount='95.25';
$currency_code='RUB';
$manual_confirmation='0';
$description='Оплата услуги А';
$reference_1='Customer 1';
$reference_2='Invoice 1';
$reference_3='Account 1';
$api_key='1EA457132ABC39FBBA99A0EEFE0BF13D';
//формируем подпись
$signature=md5("$project_id, $amount, $currency_code, $manual_confirmation, $description, $reference_1, $reference_2, $reference_3, $api_key");
//значение подписи 62849e666a6d4ea616a97e704be4c5ec
//дополнительные параметры
$success_url_raw='https://example.com/payment_success';
$success_url=base64_encode($success_url_raw);
$language='ru-RU';
//формируем ссылку
$paymentnut_payment_page="https://paymentnut.ru/api/payment/v1/project_id=$project_id&amount=$amount¤cy_code=$currency_code&manual_confirmation=$manual_confirmation&description=$description&language=$language&reference_1=$reference_1&reference_2=$reference_2&reference_3=$reference_3&success_url=$success_url=&signature=$signature";
//значение ссылки https://paymentnut.ru/api/payment/v1/project_id=0D2239F1BBDAA3E4F98CFD0CDF2F9D73&amount=95.25¤cy_code=RUB&manual_confirmation=0&description=Оплата услуги А&language=ru-RU&reference_1=Customer 1&reference_2=Invoice 1&reference_3=Account 1&success_url=aHR0cHM6Ly9leGFtcGxlLmNvbS9wYXltZW50X3N1Y2Nlc3M=&signature=62849e666a6d4ea616a97e704be4c5ec
//перенаправляем на ссылку
header("Location: $paymentnut_payment_page");
Код ошибки | Значение |
---|---|
3 | Недопустимые символы или кол–во символов в поле project_id |
4 | Недопустимые символы или кол–во символов в поле signature |
5 | Недопустимые символы или кол–во символов в поле reference_1 |
6 | Недопустимые символы или кол–во символов в поле reference_2 |
7 | Недопустимые символы или кол–во символов в поле reference_3 |
8 | Недопустимые символы или кол–во символов в поле amount |
9 | Недопустимые символы или кол–во символов в поле currency_code |
10 | Недопустимые символы или кол–во символов в поле description |
11 | Неправильный формат ссылки success_url (после расшифровки по base64) |
13 | Недопустимые символы в поле success_url (после расшифровки по base64) |
15 | Превышено максимальное кол–во символов в поле success_url (после расшифровки по base64) |
17 | Недопустимые символы или кол–во символов в поле language |
18 | Идентификатор проекта (project_id) указан неверно или проект не может принимать платежи |
19 | Неправильная подпись (signature) |
24 | Значение поля amount менее минимального |
25 | Недопустимое значение поля currency_code |
26 | Недопустимое значение поля language |
27 | Недопустимые символы или кол–во символов в поле manual_confirmation |
28 | Недопустимое значение поля manual_confirmation |
31 | Значение поля amount превышает максимальное |
35 | Недопустимое кол–во цифр после разделителя в поле amount |
36 | Недопустимые символы в поле success_url (до расшифровки по base64) |