Aller au contenu principal

Paiement par numéro de carte

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": "hot_hot_ETH"
}
}'

Référence des champs

ChampDescriptionTypeExemple
amountMontant (unités mineures)Number10000000000000000
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 côté clientStringhot_hot_ETH

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.