PaymentNut
Документация для разработчиков / Работа с API / Формирование страницы оплаты
Один из способов приема платежей – через API, когда Ваш веб–сайт программно формирует ссылку для перехода к странице оплаты PaymentNut с конкретной детализацией платежа (наименование, цена, и т.п.) и перенаправляет Вашего клиента на эту страницу. Данный способ удобен для случаев, когда у Вас большая вариативность продуктов/услуг, и ручное создание Продукта или Счета в Личном Кабинете неудобно.

URL: https://paymentnut.ru/api/payment/v1
Метод отправки: GET
Поддерживаемые параметры:

Наименование параметра Описание Допустимые символы Минимальное, максимальное кол–во знаков Допустимые значения Обязателен Пример
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

Формирование значения подписи

Подпись (параметр signature) нужна для того, что бы третье лицо не могло сформировать или изменить страницу оплаты не зная API ключ Проекта. Значение API ключа доступно в настройках Проекта Личного Кабинета его владельцу. В подпись, кроме API ключа, входят значения и других параметров платежа; финальное значение подписи шифруется по алгоритму MD5.

Для формирования значения подписи, возьмите значения параметров следующим образом: project_id, amount, currency_code, manual_confirmation, description, reference_1, reference_2, reference_3, api_key в одну строку (разделяя значения запятой и пробелом) и зашифруйте ее по алгоритму MD5.

Например (PHP):
$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




Пример сформированной ссылки для перехода к странице оплаты PaymentNut

Данный пример служит для иллюстрации корректного синтаксиса запроса, все данные в нем вымышленные и при запросе на сервер PaymentNut возвращается ошибка.

https://paymentnut.ru/api/payment/v1/project_id=0D2239F1BBDAA3E4F98CFD0CDF2F9D73&amount=95.25&currency_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

Пример формирования ссылки для оплаты и перенаправления на страницу оплаты (PHP):
$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&currency_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&currency_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)