Zahlungsanforderung per Kartennummer

Dieser Transaktionstyp ermöglicht es einem Zahlungs-Aggregator, Kundenzahlungen im Namen eines angebundenen Händlers unter Verwendung von Kartendaten 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 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": "Max Mustermann"
        },
        "description": "Zahlung",
        "txid": "hot_hot_ETH"
    }
}'

Feldreferenz

Feld	Beschreibung	Typ	Beispiel
amount	Transaktionsbetrag (kleinste Einheiten)	Number	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	Max Mustermann
description	Beschreibung	String	Zahlung
txid	Clientseitige Transaktions-ID	String	hot_hot_ETH

Hinweise

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