Документация API
В настройках вашего магазина уже есть пункт "Интеграция", вы можете скопировать код оттуда, там уже подставлены все значения.
1. Создание магазина
Укажите только название и URL проекта. Весь процесс обычно занимает не более 5 минут.Еще необходимо чтобы проект соответствовал требованиям системы.
2. Настройка магазина.
Проведите настройку магазина, включите способы оплаты.
Публичной ключ - используется для формирования подписи в форме оплаты.
Секретный ключ - используется для формирования подписи в скрипте оповещения.
URL оповещения - страница Вашего сайта, на который будут отправлены данные с информацией о платеже.
Метод отправки: POST
Успешный URL - страница Вашего сайта, на которую будет перенаправлен пользователь после успешной оплаты(мы передаем параметр label, GET-запросом).
Неудачный URL - страница Вашего сайта, на которую будет перенаправлен пользователь в случае неудачной оплаты.
3. Настройка формы оплаты (форм. ссылки)
Пример формы оплаты на html(подставьте значение: номер магазина, публичный ключ):
<form method="POST" action="https://amarapay.ru/oplata/index.php">
<input type="hidden" name="shopid" value="номер магазина">
<input type="hidden" name="pub_key" value="публичный ключ">
<input type="text" name="label" placeholder="Номер заказа ваш" required>
<input type="text" name="summa" placeholder="Сумма" required>
<button type="submit" name="create" >Оплатить</button>
</form>
Пример с php:
<?php
$shop_id = 1;
$label = nickname/email;
$amount = 100;
$secret = 'pub_key';
$hash = hash('sha256', $shop_id.$amount.$secret.$label);
$link = "https://amarapay.ru/merchant?shop_id=".$shop_id."&amount=".$amount."&label=".$label."&hash=".$hash."";
header("Location: $link");
return;
?>
shop_id - ID Вашего магазина
amount - Сумма платежа(от 1 рубля до 15000 рублей)
label - Номер заказа (также это может быть название товара или логин пользователя, для зачисления средств)
secret - публичный ключ
hash - цифровая подпись системы
method - Предлагаемый метод/способ платежа. Плательщик сможет изменить его в процессе оплаты.
desc - Описание платежа
ВАЖНО! Для создания ссылки на оплату должна быть сгенерирована подпись, с её помощью подделать данные платежа невозможно.
Подпись шифруется методом sha256, и содержит в себе:
- id магазина
- сумму
- публичный ключ
- передаваемый параметр label
После создания ссылки на оплату, при переходе на неё будут способы оплаты и сама оплата:
4. Оповещение о платеже на ваш сайт(серверное уведомление)
<?php
$id=$_POST['id'];
$label=$_POST['label'];
$date=$_POST['time'];
$shop=$_POST['shop_id'];
$suma=$_POST['amount'];
$hash=$_POST['hash'];
$secret='key'; // секретный ключ 2
$checkhash=hash('sha256',$shop.$suma.$secret.$id);
if ($hash != $checkhash) {
die('no hash');
}
//оплата прошла успешно, далее ваш код
die('200');
?>
Мы передаем на ваш сайт POST уведомление, в котором:
id - номер платежа в системе Amarapay
label - номер или название заказа в вашей системе
shop - номер магазина в AmaraPay
suma - сумма платежа
hash - подпись (HASH sha256)
ВАЖНО! Сервис AmaraPay передает подпись (HASH), для безопасности платежа.
Подпись шифруется методом sha256, и содержит в себе:
- id магазина
- сумму
- секретный ключ
- id транзакции AmaraPay