- 支付
- 私域
- 公域
- 营销
- 资金
- 会员
- 信用
- 安全
- 其他
统一收单交易结算接口
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/trade/order/settle
alipay.trade.order
\2. 同一笔订单,同步分账和异步分账不能混用。如果业务上存在一次分账请求超过5个分账收款方的情况,推荐使用异步分账。
\3. 建议支付成功后间隔 30s 再发起该接口请求
\4. 单个卖家请求频率最高 30 TPS。接口报错FREQUENCY_LIMIT 请控制请求频率
\5. 如果接口调用超时或者返回ACQ.SYSTEM_ERROR ACQ.TRADE_SETTLE_ERROR 当前请求可能成功也可能失败。请使用相同的参数再次重试调用,外部请求号和金额等均不能变更。如果前一次分账已经成功,接口会幂等返回成功;如果前一次分账请求没有成功,接口会重试执行分账操作
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/trade/order/settle' \
--header 'Content-Type: application/json' \
--data-raw '{
"extend_params": {
"royalty_finish": "true"
},
"operator_id": "A0001",
"out_request_no": "20160727001",
"royalty_mode": "async",
"royalty_parameters": [
{
"amount": "string",
"amount_percentage": 0,
"desc": "string",
"royalty_scene": "string",
"royalty_type": "string",
"trans_in": "string",
"trans_in_name": "string",
"trans_in_type": "string",
"trans_out": "string",
"trans_out_type": "string"
}
],
"trade_no": "2014030411001007850000672009"
}'
响应示例响应示例
200 - 成功示例
{
"trade_no": "2015070921001004130000127422",
"settle_no": "20210718002530070036530006474222"
}
请求参数
Body 参数application/json
extend_params
object (SettleExtendParams)
可选
royalty_finish
string
可选
示例值:
true
operator_id
string
可选
示例值:
A0001
out_request_no
string
可选
示例值:
20160727001
royalty_mode
string
可选
示例值:
async
royalty_parameters
array[object (OpenApiRoyaltyDetailInfoPojo) {10}]
可选
amount
string
可选
amount_percentage
integer
可选
desc
string
分账描述
royalty_scene
string
可选
royalty_type
string
分账类型.
trans_in
string
可选
trans_in_name
string
可选
trans_in_type
string
收入方账户类型。
trans_out
string
可选
trans_out_type
string
支出方账户类型。
trade_no
string
支付宝订单号
示例值:
2014030411001007850000672009
示例
返回响应
🟢200common response
application/json
Body
settle_no
string
可选
示例值:
20210718002530070036530006474222
trade_no
string
支付宝交易号
示例值:
2015070921001004130000127422
🔴500请求失败
修改于 2023-11-21 02:51:02