Документация Epoint API
Добро пожаловать в документацию платёжного шлюза Epoint API. Epoint позволяет принимать онлайн-платежи на вашем сайте или в приложении.
Базовый URL
Все запросы к API должны отправляться на:
Начало работы
Для начала интеграции с Epoint API необходимо:
- Зарегистрироваться как мерчант на Epoint.az
- Указать URL вашего сайта, success URL, error URL и result URL
- Получить public_key (идентификатор мерчанта) и private_key (ключ API)
Как это работает
- Ваше приложение создаёт API-запрос к Epoint с данными платежа
- Epoint возвращает URL для перенаправления на страницу оплаты банка
- Клиент вводит данные карты и подтверждает платёж
- При успехе клиент перенаправляется на
success_url; при неудаче — наerror_url - Данные и статус платежа отправляются на ваш
result_urlчерез POST-callback
Эндпоинты API
Оплата
- Создание платежа —
*** - Перенаправление на оплату —
*** - Сплит-платёж —
*** - Предавторизация —
***
Операции с картами
- Регистрация карты —
*** - Оплата сохранённой картой —
***
Статус и возвраты
- Статус платежа —
*** - Возврат средств —
*** - Отмена транзакции —
*** - Выплата —
***
Прочее
- Кошелёк — Эндпоинты для оплаты через кошелёк
- Счета — Управление счетами
- Токенизированная оплата — Apple Pay, Google Pay
- Проверка доступности — Проверка работоспособности сервиса
SDK и плагины
Готовые библиотеки и плагины для быстрой интеграции:
PHP SDK
Полнофункциональный PHP SDK, поддерживающий все эндпоинты Epoint API.
- PHP 8.2+
composer require rafoabbas/epoint-php- Документация | GitHub
Быстрый старт
1use Epoint\EpointClient;2
3$client = new EpointClient(4 publicKey: 'i000000001',5 privateKey: 'your-private-key'6);7
8$response = $client->payment()9 ->amount(100.50)10 ->orderId('ORDER-12345')11 ->description('Product purchase')12 ->send();13
14if ($response->isSuccess()) {15 header('Location: ' . $response->getRedirectUrl());16}Плагины для платформ
| Плагин | Платформа | Ссылка |
|---|---|---|
| WooCommerce | WordPress 6.6+ / WooCommerce 9.x | Документация |
| OpenCart | OpenCart 3.0.x | Документация |