payos
Методы и геоТарифыРазработчикамБезопасность
ВойтиПодключиться

Разработчикам

Интеграция за четыре шага

REST API, JSON, подписанные запросы. Документация с примерами на Node.js открыта без регистрации.
Документация APIПолучить ключи
  1. Шаг 1

    Подпиши запрос

    HMAC-SHA256 от времени, метода, пути и хеша тела. Ключ живёт только на твоём сервере.

    X-Shop-Id:    shop_…
X-Timestamp:  1793400000
X-Signature:  hex(HMAC-SHA256(secret_key,
  timestamp ⏎ METHOD ⏎ path ⏎ sha256(body)))
  2. Шаг 2

    Создай платёж

    Сумма в минимальных единицах валюты. Повтор с тем же Idempotency-Key вернёт тот же платёж.

    POST /v1/payments
Idempotency-Key: 4f1c…

{ "orderId": "A-1001", "amount": 24990,
  "currency": "EUR",
  "returnUrl": "https://shop.example/thanks" }
  3. Шаг 3

    Отправь покупателя на оплату

    Платёжная страница покажет методы для страны и валюты, примет оплату и вернёт покупателя к тебе.

    → 201
{ "id": "pay_…", "status": "created",
  "checkoutUrl": "https://pay…/c/…" }
  4. Шаг 4

    Получи вебхук

    Проверь подпись и отметь заказ оплаченным. Не ответил 2xx — повторим до двух суток.

    POST https://shop.example/payos/webhook
X-Payos-Signature: v1=…

{ "type": "payment.succeeded",
  "data": { "orderId": "A-1001", … } }

Начни принимать платежи

Регистрация и проверка компании — в кабинете. После модерации магазина сразу выдаём ключи API.
ПодключитьсяДокументация API