支付宝分账开发之交易分账结果通知接口代码
交易分账结果通知
注意：
接收通知消息前需要在支付宝开放平台-应用配置中配置应用网关地址，分账通知消息将发送到配置的地址
支付宝交易分账结果通知接口公共请求参数
| 参数 | 类型 | 是否必选 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| notify_id | String | 必选 | 50 |
通知ID
|
5608cccc09ddb39d41c2e3c06e3d9fejh2 |
| utc_timestamp | String | 必选 | 13 |
消息发送时的服务端时间
|
1514210452731 |
| msg_method | String | 必选 | 100 |
消息接口名称
|
alipay.trade.order.settle.notify |
| app_id | String | 必选 | 20 |
消息接受方的应用id
|
2014060600164699 |
| msg_type | String | 可选 | 5 |
消息类型。目前支持类型：sys：系统消息；usr，用户消息；app，应用消息
|
sys |
| msg_app_id | String | 可选 | 20 |
消息归属方的应用id。应用消息时非空
|
2016032301002387 |
| version | String | 必选 | 5 |
版本号(1.1版本为标准消息)
|
1.0或者1.1 |
| biz_content | String | 必选 |
消息报文
|
<a href=”https://opendocs.alipay.com/open/10381/gh4emp”> 参见具体的消息接口文档</a> |
|
| sign | String | 必选 |
签名
|
WcO+t3D8Kg71dTlKwN7r9PzUOXeaBJwp8/FOuSxcuSkXsoVYx BpsAidprySCjHCjmaglNcjoKJQLJ28/Asl93joTW39FX6i07lXhnbPkn ezAlwmvPdnQuI01HZsZF9V1i6ggZjBiAd5lG8bZtTxZOJ87ub2i9Gu J3Nr/NUc9VeY= |
|
| sign_type | String | 必选 | 10 |
签名类型
|
RSA2 |
| encrypt_type | String | 可选 | 10 |
加密算法
|
AES |
| charset | String | 必选 | 10 |
编码集，该字符集为验签和解密所需要的字符集
|
UTF-8 |
| notify_type | String | 可选 | 20 |
[1.0版本老协议参数]通知类型，1.1接口没有该参数
|
trade_status |
| notify_time | String | 可选 | 19 |
[1.0版本老协议参数]通知时间，北京时区，时间格式为：yyyy-MM-dd HH:mm:ss，如果服务器部署在国外请注意做时区转换。若version=1.1则可以使用utc_timestamp识别时间
|
1970-01-01 00:00:00 |
| auth_app_id | String | 可选 | 20 |
[1.0版本老协议参数]授权方的应用id
|
2016032301002387 |
消息属性
| 参数 | 类型 | 是否必选 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| out_request_no | String | 必选 | 64 |
商户分账请求号
|
20210727001 |
| settle_no | String | 必选 | 64 |
支付宝分账受理单号
|
20210706002530020036530021395831 |
| operation_dt | String | 必选 | 16 |
分账受理时间
|
2021-05-16 09:59:17 |
| royalty_detail_list | RoyaltyDetail[] | 必选 |
分账明细
|
支付宝交易分账结果通知接口响应值
| 响应值 | 描述 | 是否重试 |
|---|---|---|
| fail | 消息获取失败 | 是 |
| success | 消息获取成功 | 否 |
支付宝交易分账结果通知接口触发通知示例
ISV_GATEWAY_URL?charset=GBK&biz_content=
{
"out_request_no":"20210727001",
"settle_no":"20210706002530020036530021395831",
"operation_dt":"2021-05-16 09:59:17",
"royalty_detail_list":[{
"operation_type":"transfer",
"execute_dt":"2021-07-30 12:00:00",
"trans_out":"2088111111111111",
"trans_out_type":"userId",
"trans_in":"2088111111111111",
"trans_in_type":"userId",
"amount":10.00,
"state":"SUCCESS",
"error_code":"TXN_RESULT_ACCOUNT_BALANCE_NOT_ENOUGH",
"error_desc":"分账余额不足"
}]
}
&msg_method=alipay.trade.order.settle.notify&utc_timestamp=1516797622752&version=1.1&sign_type=RSA2¬ify_id=d275fec564e62af6bedbcee73f3f05fi5x&app_id=2013121700999429&sign=I+Y/lvqYUEEc10EPdpntRhFIQ==
