API организован вокруг архитектуры REST. В качестве основного протокола используется HTTP, а значит API подходит для любого языка программирования с поддержкой HTTP-библиотек (cURL и другие). Поддерживаются GET и POST запросы. POST запросы используют JSON в теле, GET запросы работают с параметрами пути. API всегда возвращает ответ в формате JSON, независимо от типа запроса.

API endpoint

https://api.parserpay.io/v1

Аутентификация

Авторизация запросов по идентификатору проекта и API-ключу.

Идемпотентность

Безопасные повторы создания платежей и возвратов.

Ошибки

Единый формат ошибок и справочник кодов.

Платежи

Создание платежа, статусы и получение информации.

Уведомления

Колбэки о статусе платежа с проверкой подписи.

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

Все запросы выполняются по HTTPS. Запросы без авторизации отклоняются. Чтобы создать платёж, понадобится только сумма:
curl https://api.parserpay.io/v1/payments \
  -X POST \
  -H "Authorization: Bearer <project_id>:<api_key>" \
  -H "Content-Type: application/json" \
  -d '{
        "amount": "100.00",
        "currency": "RUB",
        "description": "id:1042"
      }'
Когда платёж будет оплачен, мы отправим уведомление (webhook) на URL из настроек вашего проекта в личном кабинете.