Документация: интеграция интернет-магазина с платёжным микросервисом

1. Формирование ссылки на оплату

Для отправки пользователя на оплату сформируйте ссылку следующего вида:

https://pay.imfox.ru/payment?shop=SHOP_ID&order_id=ORDER123&amount=990.00&desc=Товар+или+услуга&customer_phone=79991234567&return_url=https://ваш_магазин.ру/payment-result

• shop — уникальный идентификатор вашего магазина (например, myshop)
• order_id — уникальный номер заказа в вашем магазине
• amount — сумма к оплате
• desc — описание заказа
• customer_phone — телефон покупателя
• return_url — URL, куда будет отправлен результат оплаты (GET-запрос и редирект пользователя)

Пример PHP-кода для генерации ссылки:

<?php
$shop = 'myshop';
$order_id = 'ORDER123';
$amount = 990.00;
$desc = urlencode('Товар или услуга');
$phone = '79991234567';
$return_url = urlencode('https://ваш_магазин.ру/payment-result');
$link = "https://pay.imfox.ru/payment?shop=$shop&order_id=$order_id&amount=$amount&desc=$desc&customer_phone=$phone&return_url=$return_url";
echo "<a href=\"$link\">Оплатить</a>";
?>

2. Получение результата оплаты

После оплаты (или неудачи) микросервис:

• Редиректит пользователя на return_url с параметрами order_id, status (success/fail), shop
• Отправляет GET-запрос (callback) на return_url с теми же параметрами

Пример обработки результата на стороне магазина:

<?php
// payment-result.php
$order_id = $_GET['order_id'] ?? '';
$status = $_GET['status'] ?? '';
$shop = $_GET['shop'] ?? '';
if ($status === 'success') {
    // Заказ успешно оплачен
    // ... ваша логика ...
    echo "Спасибо за оплату заказа $order_id!";
} else {
    // Оплата не удалась
    echo "Оплата заказа $order_id не прошла. Попробуйте ещё раз.";
}
?>

3. Интеграция с PayAnyWay

• Пользователь после подтверждения заказа перенаправляется на платёжную страницу PayAnyWay.
• После оплаты PayAnyWay отправляет callback-запрос на https://pay.imfox.ru/callback (через index.php, роутинг).
• В callback микросервис проверяет подпись, обновляет статус платежа в базе.
• В ответ PayAnyWay ожидает строку SUCCESS (или FAIL при ошибке).

Пример настройки callback в личном кабинете PayAnyWay:

https://pay.imfox.ru/callback

Пример кода для проверки подписи (уже реализовано в микросервисе):

// Для callback: md5(MNT_ID + MNT_TRANSACTION_ID + MNT_OPERATION_ID + MNT_AMOUNT + MNT_CURRENCY_CODE + SECRET_KEY)

4. Проверка уникальности платежа

Микросервис не позволит оплатить один и тот же заказ (order_id) в одном магазине (shop) дважды.

5. Сохранение контактов

Контакты (карта, телефон) сохраняются только для успешных платежей и только один раз для каждой пары (shop, карта, телефон).

6. Пример полной интеграции

<?php
// В вашем магазине:
$shop = 'myshop';
$order_id = 'ORDER123';
$amount = 990.00;
$desc = urlencode('Товар или услуга');
$phone = '79991234567';
$return_url = urlencode('https://ваш_магазин.ру/payment-result');
$link = "https://pay.imfox.ru/payment?shop=$shop&order_id=$order_id&amount=$amount&desc=$desc&customer_phone=$phone&return_url=$return_url";
echo "<a href=\"$link\">Оплатить</a>";

// В payment-result.php:
$order_id = $_GET['order_id'] ?? '';
$status = $_GET['status'] ?? '';
$shop = $_GET['shop'] ?? '';
if ($status === 'success') {
    // Заказ успешно оплачен
    // ... ваша логика ...
} else {
    // Оплата не удалась
    // ... ваша логика ...
}
?>

7. Вопросы и поддержка

По всем вопросам обращайтесь к разработчику микросервиса.

На главную