通用场景
针对商户批量汇总或单笔(包含请款提现)结算执行后，系统发送异步通知给到商户，反馈结算执行的结果。
公共请求参数
业务请求参数
dishonoured_time必选string(32)
【描述】退票时间，格式为yyyy-mm-dd hh:mm:ss。
【示例值】2009-05-06 10:07:41
fail_code必选string(32)
【描述】结算退票的原因码。
withdraw_dishonored
【示例值】withdraw_dishonored
fail_desc必选string(64)
【描述】结算退票的原因描述:
提现被退票,请联系银行客服确认银行卡信息
【示例值】提现被退票,请联系银行客服确认银行卡信息
partner_id必选string(16)
【描述】签约的支付宝账号对应的支付宝唯一用户号，以2088开头的16位纯数字组成。
【示例值】2088101106499364
settle_id必选string(32)
【描述】支付宝结算单据号
【示例值】50002016083000032007000000011833
settle_amount必选string(16)
【描述】净结算金额，取值范围[0.01,100000000]，精确到小数点后2位，单位元。
【示例值】1.01
settle_currency必选string(16)
【描述】净结算金额的币种
【示例值】cny
settle_period_begin_time必选string(32)
【描述】本次结算对应的结算周期的起始时间（包含此时间点），格式为yyyy-mm-dd hh:mm:ss。 例如，若按天结算，日切点为0点时，某一笔的结算周期时间为： settle_period_begin_time = 2018-01-01 00:00:00 settle_period_end_time = 2018-01-02 00:00:00
【示例值】2018-01-01 00:00:00
settle_period_end_time必选string(32)
【描述】本次结算对应的结算周期的起始时间（包含此时间点），格式为yyyy-mm-dd hh:mm:ss。 例如，若按天结算，日切点为0点时，某一笔的结算周期时间为： settle_period_begin_time = 2018-01-01 00:00:00 settle_period_end_time = 2018-01-02 00:00:00
【示例值】2018-01-02 00:00:00
biz_params必选string(512)
【描述】结算账户字段：
account_type表示账户类型，bank_account标识为结算到银行账户。
bank_name: 银行名称;
bank_account_no: 银行账户号，脱敏处理，只展示后4位;
bank_account_name: 银行开户名;
alipay_card_id: 支付宝卡编号;
remit_memo: 打款附言;
second_merchant_id:二级商户id;
store_id:门店id
【示例值】{"account_type":"bank_account","bank_name":"招商银行","bank_account_no":"****1234","bank_account_name":"支付宝公司","alipay_card_id":"a1234","remit_memo":"打款备注","second_merchant_id":"2088000069652893","store_id":"100001"}
biz_product必选string(32)
【描述】对应的业务产品码：在收单结算场景，对应的是收单产品码，但针对多个收单产品的交易在一个批次中进行结算时，此字段可以为空，如境外场景。
【示例值】face_to_face_payment
extend_params可选string(512)
【描述】扩展信息,单笔结算时会返回alipay_trade_no:支付宝交易号,out_request_no:外部请求号(比如请款提现场景下外部请求号),批次结算消息目前不会返回该参数
【示例值】{"alipay_trade_no":"2019121910032009460200611223","out_request_no":"201848121193"}
fail_time｜结算失败时间可选string(24)
【描述】结算失败时间，精确到秒级
【示例值】2023-06-15 20:23:34
biz_time｜结算业务时间可选string(24)
【描述】结算业务时间，精确到毫秒
【示例值】2023-06-15 20:23:34,867
响应值
| 响应值 | 描述 | 是否重试 |
|---|---|---|
| fail | 消息获取失败 | 是 |
| success | 消息获取成功 | 否 |
消息示例
isv_gateway_url?charset=gbk&biz_content=
{
"dishonoured_time":"2009-05-06 10:07:41",
"fail_code":"withdraw_dishonored",
"fail_desc":"提现被退票,请联系银行客服确认银行卡信息",
"partner_id":"2088101106499364",
"settle_id":"50002016083000032007000000011833",
"settle_amount":"1.01",
"settle_currency":"cny",
"settle_period_begin_time":"2018-01-01 00:00:00",
"settle_period_end_time":"2018-01-02 00:00:00",
"biz_params":"{\"account_type\":\"bank_account\",\"bank_name\":\"招商银行\",\"bank_account_no\":\"****1234\",\"bank_account_name\":\"支付宝公司\",\"alipay_card_id\":\"a1234\",\"remit_memo\":\"打款备注\",\"second_merchant_id\":\"2088000069652893\",\"store_id\":\"100001\"}",
"biz_product":"face_to_face_payment",
"extend_params":"{\"alipay_trade_no\":\"2019121910032009460200611223\",\"out_request_no\":\"201848121193\"}",
"fail_time":"2023-06-15 20:23:34",
"biz_time":"2023-06-15 20:23:34,867"
}
&msg_method=alipay.trade.settle.dishonoured&utc_timestamp=1516797622752&version=1.1&sign_type=rsa2¬ify_id=d275fec564e62af6bedbcee73f3f05fi5x&app_id=2013121700999429&sign=i y/lvqyueec10epdpntrhfiq==