Выплата по идентификатору кошелька
Данный тип транзакции позволяет инициировать выплату с использованием идентификатора кошелька (wallet_id).
Бизнес-процесс
- Владелец API-ключа подготавливает детали выплаты, включая wallet_id получателя.
- Создается транзакция выплаты с указанием кошелька в
money_storage. - После успешной обработки средства переводятся на указанный кошелек.
- Статус транзакции отслеживается стандартным методом получения транзакции.
Пример запроса
curl --location 'https://app.heth.me/api/v1/transactions' \
--header 'Content-Type: application/json' \
--header 'x-api-key: 440944de-e5a4-6aab-9c57-3bf2e7282c64' \
--data '{
"params": {
"amount": "10000000000000000",
"currency": "USDT",
"env": "prod",
"type": "payout",
"route": "hot_hot_ETH",
"money_storage": {
"network": "ETH",
"type": "p2p_proxy",
"currency": "USDT",
"wallet_id": "9D0089A4A8024E4724D03D2E572EB53DDE850B99"
},
"description": "Выплата",
"txid": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
}
}'
Описание полей
| Поле | Описание | Тип | Пример |
|---|---|---|---|
| amount | Сумма транзакции (целое в минорных единицах, строкой) | String | 10000000000000000 |
| currency | Валюта транзакции (по умолчанию USDT) | String | USDT |
| env | Среда выполнения (по умолчанию prod) | String | prod |
| type | Тип транзакции (payout) | String | payout |
| route | Роут обработки (должен соответствовать настроенному маппингу) | String | hot_hot_ETH |
| money_storage | Дескриптор кошелька получателя | Object | |
| >network | Blockchain-сеть (TRX или ETH) | String | ETH |
| >type | Тип взаимодействия (например p2p_proxy) | String | p2p_proxy |
| >currency | Валюта кошелька (по умолчанию USDT) | String | USDT |
| >wallet_id | Идентификатор кошелька получателя | String | 9D0089A4A8024E4724D03D2E572EB53DDE850B99 |
| description | Описание | String | Выплата |
| txid | Идемпотентный идентификатор транзакции (UUID) | String | a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d |
Примечания
- Используйте уникальный (идемпотентный)
txidдля каждого бизнес-действия, чтобы исключить повторные списания при ретраях. - Значение
routeдолжно соответствовать активному маршруту для данного API-ключа. - Статус получайте стандартным GET-запросом транзакции до достижения терминального состояния.