Подготовка к интеграции OpenAPI

Свой API-ключ

В разделе разработчика получите нужные права и ключ, настройте разрешённые адреса и лимиты. Не размещайте ключ на публичной странице и не передавайте третьим лицам. Субаккаунту нужны соответствующие права от основного аккаунта.

Отслеживаемые запросы

Передавайте ключ идемпотентности по документации и сохраняйте ID запроса и заказа. Для повтора одной операции используйте тот же ключ. После таймаута сначала запросите существующий заказ. Точные пути, поля и ошибки доступны в документации после входа.

Подготовка прав доступа

Откройте раздел разработчика из своего разрешённого аккаунта.

1. Проверьте доступ к функции; субаккаунтам также нужны права основного аккаунта.
2. Создайте Key с необходимой областью доступа и настройте IP и лимиты операций или средств.
3. Храните секреты на сервере, не в открытой веб-странице.
4. Проверьте точные пути, авторизацию и коды ошибок в текущей документации.

На иллюстрациях показаны только элементы интерфейса, без действующего API Key.

Минимальная последовательность интеграции

Сначала реализуйте запрос состояния и идемпотентность.

1. Проверьте авторизацию и IP-ограничения через операцию только для чтения.
2. Сохраняйте постоянный ключ идемпотентности для одного бизнес-запроса.
3. Записывайте идентификатор запроса и номер заказа платформы.
4. Проверяйте состояние запросом, затем подключайте уведомления и поддержку.

Диагностика ошибки

Проверьте HTTP-статус, бизнес-код, права, лимиты и ключ идемпотентности. Тайм-аут не доказывает отказ. Перед повтором запросите существующий заказ; поддержке передавайте обезличенные данные, идентификаторы и время, но не секреты или полные реквизиты карты.