Aller au contenu principal

Retrait par ID de wallet

Ce type de transaction permet d'initier un retrait en utilisant un identifiant de wallet (wallet_id).

Flux métier

  1. Le titulaire de la clé API prépare les détails du retrait, y compris la wallet_id du destinataire.
  2. Une transaction de retrait est créée en spécifiant le wallet dans money_storage.
  3. Une fois la transaction réussie, les fonds sont transférés vers le wallet spécifié.
  4. Le statut est consulté via la méthode standard de récupération d'une transaction.

Exemple de requête

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": "Retrait",
"txid": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
}
}'

Référence des champs

ChampDescriptionTypeExemple
amountMontant (entier en unités mineures, en chaîne)String10000000000000000
currencyDevise (par défaut USDT)StringUSDT
envEnvironnement (par défaut prod)Stringprod
typeType de transaction (payout)Stringpayout
routeRoute de traitement (doit correspondre au mapping configuré)Stringhot_hot_ETH
money_storageDescripteur du wallet destinataireObject
>networkRéseau blockchain (TRX ou ETH)StringETH
>typeType d'interaction (ex. p2p_proxy)Stringp2p_proxy
>currencyDevise du wallet (par défaut USDT)StringUSDT
>wallet_idIdentifiant du wallet destinataireString9D0089A4A8024E4724D03D2E572EB53DDE850B99
descriptionDescriptionStringRetrait
txidIdentifiant de transaction idempotent (UUID)Stringa1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d

Notes

  • Utilisez des valeurs txid idempotentes pour éviter les doublons.
  • route doit correspondre à une route active pour cette clé API.
  • Récupérez le statut via l'endpoint standard jusqu'à l'état final.