收付款
付款
从开发者钱包向 HTP 用户付款。
付款（Payout）用于向用户发放资金 —— 奖励、奖金、平台提现、结算款等。需要审核条款中允许付款；请在申请开通支付时勾选（否则 PAYOUT_NOT_ALLOWED）。
http
POST /open/v1/payouts
Idempotency-Key: 3e9b2c7d1f0a4b8cjson
{
"out_order_no": "P20261107-0001",
"amount": "25.00",
"currency": "USDT",
"payee_sub": "2f6c0d1e8a9b4c7d",
"description": "邀请奖励"
}| 字段 | 必填 | 说明 |
|---|---|---|
out_order_no |
✓ | 在环境内的付款单中唯一 |
amount |
✓ | USDT，最多 2 位小数 |
currency |
✓ | USDT |
payee_sub |
✓ | 收款用户的 OIDC sub |
description |
最长 255，展示给用户 |
规则
- 同步完成，
status: "SUCCEEDED"，并发送payout.completed回调。 - 从你的钱包扣除
amount，用户入账相同金额，不收手续费。 - 用户须登录过你的 App 且未取消授权（
USER_NOT_AUTHORIZED）。不能向自己付款（SELF_PAYMENT_FORBIDDEN）。 - 付款使用你的单笔 / 日 / 月限额，与收款分开累计（
LIMIT_EXCEEDED）。 - 沙箱中只能向测试用户付款（
SANDBOX_USER_ONLY）。
付款会立即转出你的资金
像对待任何转账一样保护触发付款的代码：鉴权、限流，并记录操作人。使用 Idempotency-Key，避免双击或重试导致重复付款。
超时恢复
http
GET /open/v1/orders?out_order_no=P20261107-0001&order_type=PAYOUT