Aggregierte Zahlung (Einzug für Händler)

Dieser Transaktionstyp ermöglicht es einem Zahlungs-Aggregator, Kundenzahlungen im Namen eines angebundenen Händlers zu akzeptieren. Der Betrag wird beim Zahler belastet und anschließend automatisch zwischen Händler (Netto nach Gebühr) und Aggregator (Gebühr) verteilt.

Geschäftsablauf

1. Händler schließt Onboarding / Vertrag mit dem Aggregator ab.
2. Aggregator fordert den Händler auf, in heth.me eine Wallet anzulegen und die wallet_id bereitzustellen.
3. Mit seinem eigenen API-Key erstellt der Aggregator eine payment-Transaktion: Händlerdaten in money_storage_merchant, Zahlerinstrument in money_storage.
4. Nach erfolgreicher Verarbeitung werden die Salden von Zahler, Händler und Aggregator in einem einzigen Schritt aktualisiert.
5. Der Transaktionsstatus wird über den Standard-Endpunkt (Polling mit demselben API-Key) abgefragt.

Beispiel-Request

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": "Zahlung",
      "txid": "d9428888-122b-41e1-b85c-61cb3f548aa7"
    }
  }'

Feldreferenz

Feld	Beschreibung	Typ	Beispiel
amount	Transaktionsbetrag (Ganzzahl in kleinsten Einheiten, als String)	String	10000000000000000
currency	Transaktionswährung (Standard USDT)	String	USDT
env	Ausführungsumgebung (Standard prod)	String	prod
type	Transaktionstyp (payment)	String	payment
route	Verarbeitungsroute (muss konfigurierter Zuordnung entsprechen)	String	hot_hot_ETH
money_storage_merchant	Händler-Wallet-Descriptor	Object
> wallet_id	Händler-Wallet-ID	String	002305DDA4FED2BABA57C1C70CC8E575D5D8A7AD
> network	Blockchain-Netzwerk (TRX oder ETH)	String	ETH
> type	Interaktionstyp (z.B. p2p_proxy)	String	p2p_proxy
> currency	Händler-Abrechnungswährung (Standard USDT)	String	USDT
money_storage	Zahlungsverfahren des Zahlers	Object
> network	Blockchain-Netzwerk (TRX oder ETH)	String	ETH
> type	Instrumenttyp (bank_card)	String	bank_card
> currency	Zahlerwährung (Standard USDT)	String	USDT
> cardnumber	Virtuelle Kartennummer	String	9981040364688168
> cvv	Virtueller Karten-CVV	String	128
> exp_month	Ablaufmonat	String	08
> exp_year	Ablaufjahr	String	2026
> cardholder	Karteninhaber	String	John Doe
description	Beschreibung	String	Zahlung
txid	Idempotenter Transaktionsbezeichner (UUID)	String	d9428888-122b-41e1-b85c-61cb3f548aa7

Hinweise

• Die Aggregator-Gebühr wird automatisch gemäß API-Key-Konfiguration angewendet.
• route muss einer aktivierten Route für diesen API-Key entsprechen.
• Verwenden Sie idempotente txid Werte zur Vermeidung von Doppelbuchungen.
• Status über den Standard-GET-Endpunkt abfragen (Polling bis Endzustand).