API сервиса AmaraPay

Документация 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'); 
?>