支付成功异步通知API
通知地址
通知的地址为发起支付交易的时候上送的notify_url。
通知策略
支付完成后,SaaS会把相关支付结果发送给商户,商户需要接收处理,并返回应答。对后台通知交互时,如果SaaS收到商户的应答不是成功或超时,SaaS认为通知失败,SaaS会通过一定的策略定期重新发起通知。尽可能提高通知的成功率,但不保证通知最终能成功。(通知频率为15/15/30/180/1800/1800/1800/1800/3600,单位:秒)
如果异步通知的状态与查询接口的返回存在不一致,以查询接口的返回为准。
请求参数(O-非必传 ,M-必传):
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
trade_no | 交易订单号 | String | SaaS平台的交易订单编号 | M | |
merch_no | 商户编号 | String | M | ||
out_trade_no | 服务商交易订单号 | String | 服务商的交易订单编号 | 161018121614000624679888 | M |
channel_trade_no | 凭证条码订单号 | String | 凭证条码订单号(v1.24增加) | 161018121614000624679888 | M |
total_amount | 订单金额 | String | 订单总金额,以元为单位 | 100 | M |
trade_type | 支付类型 | String | ALI:支付宝支付 | ALI | M |
pay_mode | 交易类型 | String | 主扫支付:NATIVE 被扫支付:BARPAY 服务窗支付:JSAPI 预授权:PREAUTH 预授权完成:PREAUTHFINISH |
BARPAY | M |
trade_status | 交易状态 | String | 固定为1 | 1 | M |
userid | 用户id | String | 支付宝支付的用户id | O | |
fee | 手续费 | String | 以元为单位(v1.01增加) | 1.00 | O |
rate | 费率 | String | M | ||
sn | 厂商终端号 | String | (v1.05增加) | O | |
remark | 交易备注 | String | (v1.05增加) | O | |
fee_subsidy_party | 手续费补贴方 | String | 手续费补贴方 | O | |
pre_fee_subsidy_amount | 手续费预补贴金额 | String | 手续费预补贴金额 | 1、手续费预计补贴金额是服务商上送交易费补贴金额 | C |
real_fee_subsidy_amount | 手续费实际补贴金额 | String | 手续费实际补贴金额 | 该笔交易实际补贴金额。例如:服务商上送预计手续费补贴金额为6元,根据交易费率计算手续费为5元,则该笔交易实际补贴为5元 | C |
real_fee_amount | 手续费实收金额 | String | 手续费实收金额 | 该笔交易手续费实收金额。例如:服务商上送预计手续费补贴金额为2元,根据交易费率计算手续费为5元,则商户手续费金额(5元)减去补贴金额(2元)等于手续费实收金额(3元) | C |
O | |||||
card_type | 卡类型 | String | 对应支付宝资金渠道(v1.16增加) | 详见附录--支付银行枚举 | M |
alipay_no | 支付宝平台的订单号 | String | 支付宝平台的订单号(v1.23增加) | O | |
trade_end_time | 支付完成时间 | String | 支付宝通道返回的支付完成时间 | 2019-11-18 14:11:23 | O |
attach | 支付宝原生参数 | JSON | O |
支付宝原生参数:attach
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
buyer_pay_amount | 买家实付金额 | String | 单位:元 | O | |
receipt_amount | 商家入账金额 | String | 单位:元 | O | |
mdiscount_amount | 商家优惠金额 | String | 单位:元 | O | |
discount_amount | 平台优惠金额 | String | 单位:元 | O | |
fund_bill_list | 资金渠道信息 | JSONArray | O | [{“amount”:”36.00”,”fund_channel”:”ALIPAYACCOUNT”}]” |
资金渠道信息:fund_bill_list
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
amount | 该支付工具类型所使用的金额 | String | 单位:元 | O | |
fund_channel | 交易使用的资金渠道 | String | 单位:元 | O | |
real_amount | 渠道实际付款金额 | String | 单位:元 | O |
请求示例:
{
"trade_type":"xxxx",
"trade_status":"xxx",
"out_trade_no":"xxx",
"trade_no":"xxx",
"channel_trade_no":"xxx",
"total_amount":"xxx",
"fee":"xxx",
"sn":"xxx",
"remark":"xxxx",
"userid":"xxxxx",
"sign":"xxxxx"
}
返回参数:
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
result | 接收结果 | String | 接收成功后返回“SUCCESS” | SUCCESS | M |
返回示例:
{
"result": "SUCCESS"
}
文档更新时间: 2025-02-11 11:05 作者:admin