Paiement agrégé (encaissement pour le marchand)

Ce type de transaction permet à un Agrégateur de services de paiement d'encaisser les paiements des Clients pour le compte d'un Marchand intégré. Les fonds sont débités du Payeur puis répartis automatiquement : le Marchand reçoit le montant net après commission, l'Agrégateur reçoit sa commission.

Flux métier

1. Le Marchand s'onboarde auprès de l'Agrégateur.
2. L'Agrégateur demande au Marchand de créer un wallet dans heth.me et de fournir la wallet_id.
3. Avec son propre API key, l'Agrégateur crée une transaction payment en indiquant le wallet marchand dans money_storage_merchant et la carte virtuelle du payeur dans money_storage.
4. Une fois la transaction réussie, les soldes du Payeur, du Marchand et de l'Agrégateur sont mis à jour en une seule étape.
5. Le statut est consulté via la méthode standard de récupération d'une transaction (polling avec la même clé API).

Exemple de requête

curl --location --request POST 'https://app.heth.me/api/v1/transactions' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: 165f15d4-0143-4d6a-a387-e3c44aaef7f6' \
  --data '{
    "params": {
      "amount": "10000000000000000",
      "currency": "USDT",
      "env": "prod",
      "type": "payment",
      "route": "hot_hot_ETH",
      "money_storage_merchant": {
        "wallet_id": "002305DDA4FED2BABA57C1C70CC8E575D5D8A7AD",
        "network": "ETH",
        "type": "p2p_proxy",
        "currency": "USDT"
      },
      "money_storage": {
        "network": "ETH",
        "type": "bank_card",
        "currency": "USDT",
        "cardnumber": "9981040364688168",
        "cvv": "128",
        "exp_month": "08",
        "exp_year": "2026",
        "cardholder": "John Doe"
      },
      "description": "Paiement",
      "txid": "d9428888-122b-41e1-b85c-61cb3f548aa7"
    }
  }'

Référence des champs

Champ	Description	Type	Exemple
amount	Montant (entier en unités mineures, en chaîne)	String	10000000000000000
currency	Devise (par défaut USDT)	String	USDT
env	Environnement (par défaut prod)	String	prod
type	Type de transaction (payment)	String	payment
route	Route de traitement (doit correspondre au mapping configuré)	String	hot_hot_ETH
money_storage_merchant	Descripteur du wallet marchand	Object
> wallet_id	Identifiant du wallet marchand	String	002305DDA4FED2BABA57C1C70CC8E575D5D8A7AD
> network	Réseau blockchain (TRX ou ETH)	String	ETH
> type	Type d'interaction (ex. p2p_proxy)	String	p2p_proxy
> currency	Devise de règlement marchand (par défaut USDT)	String	USDT
money_storage	Instrument de paiement du payeur	Object
> network	Réseau blockchain (TRX ou ETH)	String	ETH
> type	Type d'instrument (bank_card)	String	bank_card
> currency	Devise du payeur (par défaut USDT)	String	USDT
> cardnumber	Numéro de carte virtuelle	String	9981040364688168
> cvv	CVV de la carte virtuelle	String	128
> exp_month	Mois d'expiration	String	08
> exp_year	Année d'expiration	String	2026
> cardholder	Titulaire de la carte	String	John Doe
description	Description	String	Paiement
txid	Identifiant de transaction idempotent (UUID)	String	d9428888-122b-41e1-b85c-61cb3f548aa7

Notes

• La commission de l'Agrégateur est appliquée automatiquement selon la configuration de la clé API.
• route doit correspondre à une route active pour cette clé API.
• Utilisez des valeurs txid idempotentes pour éviter les doublons.
• Récupérez le statut via l'endpoint standard jusqu'à l'état final.