Создание платежа (простой способ)

Создание платежа

GET https://unitpay.money/pay/PUBLIC-KEY?sum&account&desc&signature

Для инициализации платежа посредством единой формы оплаты вам достаточно направить пользователя по специальному URL и передать ряд обязательных для оплаты параметров.

Основные параметры:

Name	Type	Description
sum	number	Сумма платежа. По умолчанию в USD. См. дополнительный параметр currency.
account	string	Идентификатор абонента в вашей системе (например email или номер заказа).
desc	string	Описание заказа. Используется только для информирования при совершении платежа.
signature	string	Цифровая подпись запроса. Она защищает вас от злоумышленников - подмены описания или стоимости заказа, размещения ссылки на оплату на ресурсах мошенников. Образуется как sha256(account + "{up}" + currency + "{up}" + desc + "{up}" + sum + "{up}" + secretKey), где sha256 - метод хеширования; "{up}" - разделитель параметров в хеш-функции; secretKey - секретный ключ проекта (доступен в настройках проекта); Важно. Если вы не передаете currency на форму оплаты, то этот параметр не должен участвовать в формировании подписи.

Значение PUBLIC KEY и SECRET KEY проекта можно найти на странице Настройки проекта

Дополнительные параметры:

currency	string	Валюта заказа по стандарту ISO 4217 (EUR, USD, RUB, UAH, BYN и тд. Полный список валют). Если платежная система не поддерживает требуемую валюту, то сумма будет сконвертирована в валюту системы оплаты.
locale	string	Принудительное указание языка платежной формы, допустимые значения: ru, en. По умолчанию язык формы определяется исходя из страны, к которой относится IP адрес пользователя.
backUrl	string	платежной формы без совершения покупки, по умолчанию используется адрес проекта. В адресе обязательно должен использоваться домен проекта. Примеры: https://redirect.<домен проекта>/?someParams https://<домен проекта>/redirect/
subscription	string	Используйте данный флаг, если требуется создать подписку по карте плательщика. Идентификатор подписки (subscriptionId) будет передан в методе PAY на ваш обработчик платежа. Использование подписок возможно только после согласования со службой безопасности.

Пример формирования цифровой подписи:

PHP

function getFormSignature($account, $currency, $desc, $sum, $secretKey) {
    $hashStr = $account.'{up}'.$currency.'{up}'.$desc.'{up}'.$sum.'{up}'.$secretKey;
    return hash('sha256', $hashStr);
}

Perl

sub getSignature {
    my ($method, $params, $secretKey) = @_;
    delete $params->{sign};
    delete $params->{signature};
    my $s = $method;
    foreach my $key (sort keys %{$params}) {
        $s .= '{up}' . $params->{$key};
    }
    $s .= '{up}' . $secretKey;
    use Digest::SHA qw(sha256_hex);
    return sha256_hex($s);
}

Пример правильно сформированной ссылки на оплату:

https://unitpay.money/pay/111111-1b1c1?sum=100&account=[e-mail]&desc=Online%20course&signature=2c38bb3114b2f02222ee35f6b60c6bbe628ad31bed59633787204ae59659a02e

Метод оплаты по умолчанию

Вы можете определить платежную систему, которая будет использоваться по умолчанию для пользователя. Для этого в конец URL вашей платежной формы добавьте параметр / код_системы, соответствующий буквенному коду платежной системы.

Возврат на сайт магазина

После инициализации оплаты пользователь переходит на страницу чека, где отслеживается статус платежа. При получении успешного либо ошибочного статуса пользователь переходит на сайт партнера по кнопке "В магазин" (поля Fail URL/Success URL в настройках личного кабинета) с GET параметрами:

	Значение	Описание
account	текст	Идентификатор абонента в системе партнера (например, логин или email)
paymentId	число	Номер платежа в системе UnitPay

Если необходимо принудительно редиректить пользователей сразу после успешной оплаты, то воспользуйтесь параметром resultUrl из запроса на создание платежа.