POST transaction_settlement.settled
请求头
所有 webhook 请求都包含以下请求头，用于身份验证和验证：
| 请求头 | 描述 |
|---|---|
| X-PARTNER-ID | 您的客户端标识符 |
| X-TIMESTAMP | 请求时间戳，采用 ISO8601 格式 (e.g., 2024-12-18T16:21:07+07:00) |
| X-SIGNATURE | 用于请求验证的 RSA 签名（参见签名生成） |
负载结构
| 名称 | 类型 | 描述 |
|---|---|---|
| event | string | 事件名称："transaction_settlement.settled" |
| timestamp | string | 事件时间戳（ISO 8601 格式） |
| data | object | 结算明细 |
| data.id | string | 结算单 ID（ULID 格式，带 "txs" 前缀） |
| data.total_amount | string | 结算总金额（含手续费） |
| data.fee_amount | string | 总手续费金额 |
| data.nett_amount | string | 净额（扣除手续费后） |
| data.transaction_count | integer | 本次结算包含的交易笔数 |
| data.started_at | string/null | 结算开始时间（ISO 8601 格式） |
| data.settled_at | string | 结算完成时间（ISO 8601 格式） |
| data.description | string/null | 结算备注说明 |
示例负载
{
"event": "transaction_settlement.settled",
"timestamp": "2026-03-22T10:05:00+07:00",
"data": {
"id": "txs-01jq7m3k9xzv2b8n4hd5tcfw6e",
"total_amount": "1500000.00",
"fee_amount": "15000.00",
"nett_amount": "1485000.00",
"transaction_count": 12,
"started_at": "2026-03-22T09:00:00+07:00",
"settled_at": "2026-03-22T10:05:00+07:00",
"description": "Daily settlement batch"
}
}