聚合支付（商户按卡号收款）
示例：当小数 = 6 时，"1000000" 为 1 USDT。将所有占位符替换为经过验证的收件人和仪器详细信息。发送此请求可以转移真实资金。在提交操作之前进行审查并明确授权该操作。请参阅快速入门。
此交易类型使支付服务聚合器能够代表集成商户接受客户付款。资金从付款人处扣除，并自动在商户（扣除聚合商费用）和聚合商（费用部分）之间分配。
业务流程
- 商户与聚合商签署协议/加入。
- 聚合器指示商家在 heth.me 系统中创建（或提供）钱包并发回
wallet_id。 - 使用自己的 API 密钥，聚合器创建支付交易，指定
money_storage_merchant中的商户钱包详细信息和money_storage中的付款人卡详细信息。 - 成功处理后，付款人、商户和聚合商的余额将一步更新。
- 可以使用标准交易检索方法（使用相同的 API 密钥授权）轮询交易状态。
请求示例
curl --location --request POST 'https://app.heth.me/api/v1/transactions' \
--header 'Content-Type: application/json' \
--header "x-api-key: $HETH_API_KEY" \
--data '{
"params": {
"amount": "1000000",
"currency": "USDT",
"env": "prod",
"type": "payment",
"route": "hot_hot_ETH",
"money_storage_merchant": {
"wallet_id": "YOUR_WALLET_ID",
"network": "ETH",
"type": "p2p_proxy",
"currency": "USDT"
},
"money_storage": {
"network": "ETH",
"type": "bank_card",
"currency": "USDT",
"cardnumber": "YOUR_CARD_NUMBER",
"cvv": "YOUR_CVV",
"exp_month": "08",
"exp_year": "2026",
"cardholder": "John Doe"
},
"description": "Payment",
"txid": "d9428888-122b-41e1-b85c-61cb3f548aa7"
}
}'
现场参考
| 领域 | 描述 | 类型 | 示例 |
|---|---|---|---|
| amount | 交易金额（最小货币单位整数字符串） | String | 1000000 |
| currency | 交易币种（默认USDT） | String | USDT |
| env | prod（默认）。打开并确认请求时保留该值。 | String | prod |
| type | 交易类型（支付） | String | payment |
| route | 处理路由（必须匹配配置的映射） | String | hot_hot_ETH |
| money_storage_merchant | 商户（收款人）钱包描述符 | Object | |
| > wallet_id | 商户钱包标识符 | String | YOUR_WALLET_ID |
| > network | 区块链网络（TRX 或 ETH） | String | ETH |
| > type | 钱包交互类型（例如 p2p_proxy） | String | p2p_proxy |
| > currency | 商户结算币种（默认USDT） | String | USDT |
| money_storage | 付款人融资工具描述符 | Object | |
| > network | 区块链网络（TRX 或 ETH） | String | ETH |
| > type | 工具类型（银行卡） | String | bank_card |
| > currency | 付款人货币（默认USDT） | String | USDT |
| > cardnumber | 虚拟卡号 | String | YOUR_CARD_NUMBER |
| > cvv | 虚拟卡CVV | String | YOUR_CVV |
| > exp_month | 卡到期月份 | String | 08 |
| > exp_year | 卡到期年份 | String | 2026 |
| > cardholder | 持卡人姓名 | String | John Doe |
| description | 人类可读的描述 | String | Payment |
| txid | 幂等事务标识符（字符串） | String | d9428888-122b-41e1-b85c-61cb3f548aa7 |
注释
- 聚合器费用逻辑根据 API 密钥配置自动应用。
- 确保
route与所提供的 API 密钥的启用处理路由匹配。 - 使用幂等
txid值以避免意外重复提交。 - 通过标准 GET 交易端点检索交易状态（轮询直到达到最终状态）。