> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.6mm.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.6mm.com/_mcp/server.

# SDK Діагностика інтеграції

Почніть з середовища, часової позначки та ідентифікатора бізнесу для невдалої операції. Структурована перевірка зазвичай розділяє проблеми конфігурації від аутентифікації, мережевої та асинхронної обробки.

<h2 id="diagnostic-order">
  Рекомендований діагностичний порядок
</h2>

1. Підтвердити уражене середовище та базову URL.
2. Запишіть UTC часовий діапазон і перший невдалий запит.
3. Визначте модуль: Trading Widget, Agent SDK, REST API, WebSocket, або webhook.
4. Зафіксуйте ідентифікатор запиту, ідентифікатор користувача партнера, `agentOrderNo`, ID замовлення або вебхук.
5. Перевірте останні зміни в коді, облікові дані, IP білий список або розгортання.
6. Відтворити з найменшим безпечним тестовим випадком.

<h2 id="trading-widget-issues">
  Trading Widget проблеми
</h2>

| Симптоми                                    | Ймовірна причина                                        | Виправлення                                                      |
| ------------------------------------------- | ------------------------------------------------------- | ---------------------------------------------------------------- |
| iframe запитує партнерський локальний домен | baseUrl відсутня                                        | Передайте baseUrl: '[https://app.6mm.com](https://app.6mm.com)'. |
| iframe невидимий або дуже короткий          | Батьківський контейнер не має висоти                    | Встановіть висоту контейнера або висоту проходу.                 |
| token\_provider\_missing                    | Режим Partner-Token не має провайдера                   | Додайте автентифікаціюtokenProvider.                             |
| auth\_exchange\_failed                      | Недійсний, прострочений або невідповідний токен вбудови | Перевірте відповідь бекенд-токена та channelId.                  |

<h2 id="agent-sdk-issues">
  Agent SDK проблеми
</h2>

| Симптоми                            | Ймовірна причина                                                     | Виправлення                                                             |
| ----------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| Підпис відхилено                    | Неправильний секрет, зсув годинника або ручна зміна підписаних полів | Дозвольте SDK генерувати поля підписання та синхронізувати час сервера. |
| Ризик переміщення дублювання коштів | Новий номер замовлення використовується після тайм-ауту              | Спочатку запит за оригінальним agentOrderNo .                           |
| PROCESSING вважали провалом         | Неправильно зрозумілий стан очікування                               | Зачекайте на webhook або зателефонуйте queryOrder.                      |
| Вебхук оброблявся кілька разів      | Спробуйте повторити поведінку без ідемпотентності                    | Додайте ключ ідемпотентності та перевірки фінального стану.             |

<h2 id="evidence-to-capture">
  Докази для захоплення
</h2>

| Інтеграція     | Корисні докази                                                                                                                  |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Trading Widget | Сторінка URL, SDK шлях версії, консоль браузера, невдалі мережеві запити, `onError` корисне навантаження та розміри контейнера. |
| Agent SDK      | SDK мова/версія, базова URL, UTC часова мітка, ідентифікатор запиту, `agentOrderNo`, код відповіді та очищені журнали.          |
| Webhook        | Час доставки, ключ події або бізнесу, результат валідації підпису, стан обробки та очищений raw body хеш.                       |
| REST API       | Метод, шлях, середовище, ідентифікатор запиту, код відповіді та прочистлені параметри.                                          |

Ніколи не включайте паролі, токени доступу, API секрети, повні підписи, приватні ключі чи невідредаговані персональні дані в діагностиці.

<h2 id="before-escalating">
  Перед ескалацією
</h2>

* Спробуйте повторити лише тоді, коли операція задокументована як безпечна для повторної спроби.
* Після тайм-ауту запитуйте оригінальний бізнес-ідентифікатор замість створення нового.
* Підтвердити системний тактовий сигнал і середовище облікових даних на наявність помилок підпису.
* Зберегти першу невдачу та будь-які наступні результати повторних спроб.
* Використовуйте [Шаблон запиту підтримки](/uk/resources/support-request-template) для надсилання повного, відредагованого звіту.

<h2 id="related-docs">
  Пов'язані документи
</h2>

#### [Trading Widget Швидкий початок](/uk/sdk/trading-widget/quick-start)

Перевірте завантаження скриптів, розмір контейнера, конфігурацію та зворотні виклики.

#### [Секрети та підписання](/uk/sdk/security/secrets-signing)

Перевірте Agent SDK облікові дані, годинники та підписані поля.

#### [Вебхуки та ідемпотентність](/uk/sdk/security/webhooks-idempotency)

Перегляньте перевірку зворотного дзвінка та обробку дублювання події.