> 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.

# 6MM Agent SDK

> Використовуйте 6MM Agent SDK для підписаних API-викликів із Java- і PHP-бекендів, прив’язування користувачів, переказів активів, створення URL входу в торгівлю, ідемпотентної обробки та перевірки вебхуків.

Цей 6MM Agent SDK призначений для партнерських бекенд-сервісів, які повинні викликати привілейований агент API без реалізації підписання та обробки запитів з нуля. Він не повинен працювати у браузері, мобільному або публічному робочому столі, оскільки інтеграція використовує партнерський API секрет.

<h2 id="when-to-use-the-agent-sdk">
  Коли користуватися Agent SDK
</h2>

Використовуйте Agent SDK, коли бекенду потрібно пов’язати користувача партнера, перемістити активи за затвердженим робочим процесом, отримати торгові записи, створити URL для входу у вбудовану торгівлю або перевірити сповіщення Webhook. Використовуйте [Trading Widget SDK](/uk/sdk/trading-widget/overview) окремо, коли партнерський фронтенд має відображати торговий інтерфейс.

<h2 id="capabilities">
  Можливості
</h2>

| Сценарій                         | Java SDK      | PHP SDK       |
| -------------------------------- | ------------- | ------------- |
| Прив'язати користувача           | Підтримується | Підтримується |
| Фіксована сума переказу          | Підтримується | Підтримується |
| Переведіть усе                   | Підтримується | Підтримується |
| Зворотний трансфер               | Підтримується | Підтримується |
| Ордер запиту                     | Підтримується | Підтримується |
| Створити запис URL               | Підтримується | Підтримується |
| Верифікація за допомогою вебхука | Підтримується | Підтримується |

<h2 id="common-configuration">
  Поширена конфігурація
</h2>

| Ключ            | Приклад                                                                            | Опис                                                 |
| --------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------- |
| baseUrl         | `https://agent-api.6mm.com`                                                        | 6MM Агент API сервіс URL без сліду слешу.            |
| agentCode       | AGENT001                                                                           | Код партнера-агента.                                 |
| apiSecret       | твій-апі-таємниця                                                                  | API секрет підпису зберігається лише на бекенді.     |
| defaultCurrency | USDT                                                                               | Валюта за замовчуванням для переказу та рахунку API. |
| webhookUrl      | [https://partner.example.com/6mm/webhook](https://partner.example.com/6mm/webhook) | Партнерська кінцева точка для 6MM сповіщень webhook. |

<h2 id="typical-integration-flow">
  Типовий потік інтегрування
</h2>

1. Партнерський фронтенд автентифікує користувача через власну систему облікового запису партнера.
2. Партнерський бекенд відображає користувача на стабільний ідентифікатор партнерської сторони.
3. Бекенд називає Agent SDK з `agentCode` і захищеним API секретом.
4. SDK підписує і надсилає агенту API запит.
5. Бекенд зберігає повернений бізнес-ідентифікатор і обробляє наступні вебхуки ідемпотентно.
6. Фронтенд отримує лише короткочасний результат або вступний сертифікат, який йому потрібен.

<h2 id="choose-an-sdk">
  Обери SDK
</h2>

| Бекенд-стек | Почніть тут                                                                                                     |
| ----------- | --------------------------------------------------------------------------------------------------------------- |
| Java        | [Java SDK Огляд](/uk/sdk/agent-sdk/java/overview) та [Java Швидкий початок](/uk/sdk/agent-sdk/java/quick-start) |
| PHP         | [PHP SDK Огляд](/uk/sdk/agent-sdk/php/overview) та [PHP Швидкий початок](/uk/sdk/agent-sdk/php/quick-start)     |

<h2 id="production-checklist">
  Чек-лист виробництва
</h2>

* Завантажувати `apiSecret` з бекенд-менеджера секретів, а не з вихідного коду.
* Тримайте окремо розробку, постановку та виробничі сертифікати.
* Використовуйте стабільне партнерське відображення користувача та унікальні ідентифікатори бізнес-порядку.
* Зберегти оригінальний ідентифікатор при перевірці статусу запиту з тайм-аутом.
* Перевірка підписів вебхуків та зберігання оброблених ідентифікаторів подій.
* Редагувати секрети та підписи з журналів, зберігаючи ідентифікатори запитів для підтримки.

<h2 id="next-steps">
  Наступні кроки
</h2>

#### [Java Швидкий початок](/uk/sdk/agent-sdk/java/quick-start)

Встановіть і ініціалізуйте Agent SDK на Java бекенді.

#### [PHP Швидкий початок](/uk/sdk/agent-sdk/php/quick-start)

Встановіть і ініціалізуйте Agent SDK на PHP бекенді.

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

Перевіряйте зворотні дзвінки та запобігайте дублювати бізнес-обробці.