Начало работы

Что нужно для первого запроса к API Plutera и что API умеет сегодня.

Plutera принимает платежи мерчанта и ведёт их к платёжным провайдерам. С API работает сервер мерчанта. Документация описывает только то, что выпущено и проверено на работающем сервере.

#Что нужно знать сразу

• Адрес API один для тестового и боевого контура: https://api.plutera.io. Все ручки начинаются с /api/v1. Только HTTPS.
• API вызывается с сервера. Заголовков CORS нет намеренно: ключ API не должен попадать в код страницы или приложения.
• Запросы и ответы в JSON, кодировка UTF-8.
• Каждый запрос несёт ключ API. Ключ определяет мерчанта и контур.
• Суммы это целые числа минорных единиц валюты, записанные строкой.
• У каждого ответа есть номер запроса для обращения в поддержку.

#Первый запрос

1. Получите тестовый ключ у администратора Plutera. Как устроен ключ и где его выдают: Авторизация.

2. Положите ключ в переменную окружения на своём сервере. В командах документации ключ берётся оттуда.

   export PLUTERA_API_KEY='ключ, который вам выдали'

3. Проверьте ключ:

   curl -sS https://api.plutera.io/api/v1/me \
     -H "Authorization: Bearer $PLUTERA_API_KEY"

   В ответ придут мерчант, контур и открытая часть ключа: поля и пример ответа. Если пришёл отказ, его причина названа в теле: Формат ошибок.

#Что API умеет сегодня

Обе ручки только читают. Создание платежа, чтение его состояния и уведомления мерчанту ещё не выпущены: их адреса зарезервированы. Ручка появляется в справочнике и в журнале изменений в день выпуска, не раньше.