Документация для разработчиков

Создано для разработчиков

Один REST API. Все армянские процессоры. Запуск за 5 минут.

Полная документация API Получить API-ключ

REST + JSON HMAC-подпись JS SDK

REST API

JSON-запросы / ответы

JS SDK

Inline, модальное окно, редирект

Вебхуки

Подписаны HMAC-SHA256

OpenAPI

Автоматически генерируемая документация

Быстрый старт

Четыре шага до запуска

Зарегистрируйтесь и получите API-ключ

Создайте аккаунт, подтвердите email и сгенерируйте API-ключ в панели управления. Ключ показывается один раз — сохраните его в надёжном месте.

auth-header

# Your API key header
X-Paynet-Key: pk_live_a1b2c3d4e5f6...

Создайте платёж через API

Отправьте POST на /api/v1/payments с данными вашего заказа. В ответе получите checkout_url.

create-payment.sh

curl -X POST https://paynet.am/api/v1/payments \
  -H "X-Paynet-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 500000,
    "currency": "AMD",
    "order_id": "ORD-2024-001",
    "processor": "idram",
    "domain": "shop.am",
    "return_url": "https://shop.am/thanks",
    "callback_url": "https://shop.am/webhooks/paynet"
  }'

Перенаправьте покупателя на страницу оплаты

Используйте checkout_url из ответа для редиректа или встройте inline с помощью JS SDK.

Ответ · 201 Created

response.json

{
  "uuid": "018e7b2c-...",
  "checkout_url": "https://paynet.am/pay/018e7b2c-...",
  "status": "pending"
}

Получите вебхук по завершении

Paynet отправляет подписанный вебхук на ваш callback_url при изменении статуса платежа. Проверьте подпись HMAC-SHA256 и обновите статус заказа.

REST API

Создавайте платежи одним запросом

Передайте сумму, валюту, процессор и URL обратного вызова. Мы автоматически обработаем протоколы, специфичные для процессора, подставим учётные данные и верифицируем коллбэки.

JSON-запросы / ответы

Аутентификация по API-ключу (хэш SHA-256)

Автоматически генерируемая документация OpenAPI

Идемпотентные запросы через order_id

Идентификаторы транзакций на основе UUID

Смотреть полную документацию API

create-payment.sh

# Create a payment
curl -X POST https://paynet.am/api/v1/payments \
  -H "X-Paynet-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 500000,
    "currency": "AMD",
    "order_id": "ORD-2024-001",
    "processor": "idram",
    "domain": "shop.am",
    "return_url": "https://shop.am/thanks",
    "callback_url": "https://shop.am/webhooks/paynet"
  }'

# Response: 201 Created
{
  "uuid": "018e7b2c-...",
  "checkout_url": "https://paynet.am/pay/018e7b2c-...",
  "status": "pending"
}

Вебхуки

Уведомления о платежах в реальном времени

Paynet отправляет подписанные вебхук-запросы на ваш эндпоинт при каждом изменении статуса платежа. Автоматические повторные попытки с экспоненциальной задержкой гарантируют доставку.

Полезные нагрузки с подписью HMAC-SHA256

Автоматические повторные попытки с задержкой

Журналы доставки в панели управления

Идемпотентные идентификаторы доставки

Проверьте заголовок X-Paynet-Signature с помощью HMAC-SHA256 и вашего секрета вебхука.

webhook-payload.sh

# Webhook delivery
POST https://shop.am/webhooks/paynet
X-Paynet-Signature: sha256=abc123...
X-Paynet-Delivery: dlv_018e7b2c...

{
  "event": "payment.completed",
  "transaction": {
    "uuid": "018e7b2c-...",
    "order_id": "ORD-2024-001",
    "amount": 500000,
    "currency": "AMD",
    "status": "completed",
    "processor": "idram"
  }
}

Тестовый режим

Разрабатывайте в полноценной песочнице

Каждый аккаунт имеет тестовые API-ключи (с тестовым префиксом). Платежи, созданные с тестовым ключом, проходят через фиктивный процессор — реальные деньги не перемещаются, активная подписка не требуется. Переключитесь на вкладку «Тест» в панели транзакций, чтобы их увидеть.

Отдельные тестовые API-ключи

Фиктивный процессор — мгновенные результаты

Магические номера карт для каждого исхода

Переключатель Live/Test в панели управления

Магические тестовые карты

# Платёж одобрен
4111 1111 1111 1111
# Отклонено эмитентом
4000 0000 0000 0002
# Недостаточно средств
4000 0000 0000 0069
# Тайм-аут процессора
4000 0000 0000 0119

JavaScript SDK

Встройте оплату на свой сайт

Подключите наш лёгкий JS SDK и откройте страницу оплаты в режиме inline-встраивания, модального окна или полностраничного редиректа. Три режима, один тег script.

Inline

Встраивается в контейнер div на странице

Модальное окно

Всплывающее окно без ухода со страницы

Редирект

Полностраничный переход на размещённую страницу оплаты

checkout.js

<!-- Load the SDK -->
<script src="https://paynet.am/sdk/v1/paynet.js">
</script>

<!-- Container for inline mode -->
<div id="paynet-container"></div>

<script>
Paynet.open({
  checkoutUrl: "{{ checkout_url }}",
  mode: "inline",
  container: "#paynet-container",
  onSuccess: function(data) {
    console.log("Paid:", data.order_id);
  },
  onError: function(error) {
    console.error("Failed:", error.message);
  }
});
</script>

Плагины для платформ

Интеграция без кода

Не хотите писать код? Установите готовый плагин для вашей платформы.

Начните разработку

Готовы к интеграции?

Получите API-ключ и начните принимать платежи менее чем за 5 минут.