Кожна помилка API надходить із коротким кодом і зрозумілим повідомленням. Ось ті, з якими мерчанти стикаються найчастіше.
Ключі та доступ
- unauthenticated / invalid_credentials: ключ проєкту або секрет відсутній чи неправильний. Перевірте, чи немає зайвих пробілів і чи належить секрет саме цьому проєкту.
- project_inactive: ви використали бойовий секрет до схвалення проєкту. До схвалення використовуйте тестовий секрет, див. Перевірка проєкту: що й коли перевіряємо.
- project_disabled: проєкт призупинено або не схвалено.
- ip_not_allowed: виклик надійшов з адреси, якої немає в списку дозволених IP для API цього проєкту.
Ваш запит
- invalid_request: поле відсутнє або заповнене в неправильному форматі. У повідомленні вказано, яке саме.
- duplicate_order_id: платіж із таким order ID уже існує в цьому режимі. Використайте новий або знайдіть наявний платіж.
- insufficient_funds: коштів на балансі не вистачає для покупки скіна. У повідомленні вказано, скільки потрібно.
Ліміти запитів
Проєкт може робити до 600 викликів на хвилину. Понад це ви отримаєте rate_limited з підказкою, коли повторити. Зачекайте, а не повторюйте запит у щільному циклі.
Коли маркет перевантажений
Якщо платіжна мережа не відповідає, ви отримаєте повідомлення з проханням повторити за хвилину. Order ID і custom ID унікальні в межах проєкту, тож повтор ніколи не створить другий платіж чи покупку. Повторний виклик покупки з тим самим custom ID поверне вже наявну покупку.
Повний перелік помилок, полів і прикладів — у довіднику API.