支付成功异步通知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
market_subsidy_info 营销补贴信息 JSONArray 此笔交易营销补贴信息详情 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
营销补贴信息:market_subsidy_info
参数 参数名称 类型 参数说明 样例 可空
party 营销补贴账户 String 在海科开通的营销补贴账户号 M
amt 营销补贴金额 String 营销补贴金额(单位:元) 20 M
支付宝原生参数: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"
}
文档更新时间: 2023-07-13 14:16   作者:admin