> For the complete documentation index, see [llms.txt](https://docs.paysync.bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.paysync.bot/obshee/perevod-na-vneshnii-adres.md).

# Перевод на внешний адрес 

Все запросы к API должны быть отправлены по следующему базовому URL:

Базовый URL `https://paysync.bot/send/usdt`

Аутентификация

Некоторые эндпоинты API могут требовать аутентификации с использованием API-ключа. Для получения API-ключа Зайдите в [нашего бота](https://t.me/paysyncbot) Telegram нажмите

```
⚙️ Настройки > Настройки API > Выпустить токен
```

cURL

```http
curl -X POST -H "Content-Type: application/json" -d '{"apikey":"your_api_key","amount":100.0,"address":"recipient_address"}' https://paysync.bot/send/usdt
```

**Параметры запроса**

| Имя параметра | Тип данных | Обязательно | Описание                                                                                |
| ------------- | ---------- | ----------- | --------------------------------------------------------------------------------------- |
| apikey        | float      | +           | Уникальный api-ключ из бота [@PaySyncBot](https://t.me/paysyncbot) он же ключ доступа . |
| amount        | string     | +           | Сумма для вывода средств в USDT TRC20.                                                  |
| address       | string     | +           | Адрес кошелька USDT TRC20.                                                              |
| pin           | int        | -           | 4-значный пин-код, если он установлен владельцем аккаунта                               |

Пин-код вывода

```abap
Если на аккаунте установлен пин-код (задаётся в приложении PaySync или веб-кабинете),
поле `pin` обязательно. Без него или при неверном значении вывод отклоняется:

- `400 {"error": "PIN code is required for withdrawals (4 digits)", "pin_required": true}` — поле `pin` отсутствует или не 4 цифры;
- `400 {"error": "Wrong PIN code. Attempts left: N", "pin_required": true}` — неверный пин, `N` — оставшиеся попытки;
- `403 {"error": "Wrong PIN 3 times. Withdrawals are blocked. Contact support."}` — исчерпаны 3 попытки, аккаунт блокируется (rule=4), дальнейшие выводы невозможны до обращения в поддержку;
- `403 {"error": "Withdrawals are not allowed for this account"}` — аккаунт уже заблокирован (rule=4).

При верном пине запрос обрабатывается как обычно (создание заявки на вывод).
Счётчик неверных попыток сбрасывается после успешного вывода, смены пин-кода
или через 15 минут неактивности.
```

**Примечание:** интеграции, созданные до введения пин-кодов, продолжают работать без поля `pin`, пока владелец аккаунта не установит пин-код.

**Пример ответа**

```json
{
    'address': address, 
    'amount': amount, 
    'status':'success', 
    'time': current_time
}
```