Платёж через агрегатора (приём в пользу мерчанта)

Данный тип транзакции позволяет Платёжному Агрегатору принимать платежи Покупателей в пользу подключённого Мерчанта. Средства списываются с Плательщика и автоматически распределяются: Мерчант получает сумму за вычетом комиссии, Агрегатор получает свою комиссию.

Бизнес-процесс

1. Мерчант обращается к Агрегатору и проходит онбординг.
2. Агрегатор просит Мерчанта создать кошелёк в системе heth.me и предоставить wallet_id.
3. Используя свой API-ключ, Агрегатор формирует транзакцию типа payment, указывая кошелёк мерчанта в money_storage_merchant и платёжные реквизиты покупателя в money_storage.
4. После успешной обработки балансы Плательщика, Мерчанта и Агрегатора обновляются единым действием.
5. Статус транзакции отслеживается стандартным методом получения транзакции (переопрос, авторизация тем же API-ключом).

Пример запроса

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": "Платёж",
      "txid": "hot_hot_ETH"
    }
  }'

Описание полей

Поле	Описание	Тип	Пример
amount	Сумма транзакции (в минорных единицах)	Number	10000000000000000000
currency	Валюта транзакции (по умолчанию USDT)	String	USDT
env	Среда выполнения (по умолчанию prod)	String	prod
type	Тип транзакции (payment)	String	payment
route	Роут обработки (должен соответствовать настроенному маппингу)	String	hot_hot_ETH
money_storage_merchant	Дескриптор кошелька мерчанта (получателя)	Object
> wallet_id	Идентификатор кошелька мерчанта	String	002305DDA4FED2BABA57C1C70CC8E575D5D8A7AD
> network	Blockchain-сеть (TRX или ETH)	String	ETH
> type	Тип взаимодействия (например p2p_proxy)	String	p2p_proxy
> currency	Валюта зачисления мерчанту (по умолчанию USDT)	String	USDT
money_storage	Дескриптор платёжного инструмента плательщика	Object
> network	Blockchain-сеть (TRX или ETH)	String	ETH
> type	Тип инструмента (bank_card)	String	bank_card
> currency	Валюта плательщика (по умолчанию USDT)	String	USDT
> cardnumber	Номер виртуальной карты	String	9981040364688168
> cvv	CVV виртуальной карты	String	128
> exp_month	Месяц окончания срока действия	String	08
> exp_year	Год окончания срока действия	String	2026
> cardholder	Имя держателя карты	String	John Doe
description	Описание	String	Платёж
txid	Идентификатор транзакции на стороне клиента	String	hot_hot_ETH

Примечания

• Комиссия Агрегатора учитывается автоматически согласно настройкам API-ключа.
• Значение route должно соответствовать активному маршруту для данного API-ключа.
• Используйте уникальный (идемпотентный) txid для каждого бизнес-действия, чтобы исключить повторные списания при ретраях.
• Статус получайте стандартным GET-запросом транзакции до достижения терминального состояния.