支付成功异步通知

概要描述:

通知地址
通知的地址为发起支付交易的时候上送的notify_url。

通知策略
支付完成后，SaaS会把相关支付结果发送给商户，商户需要接收处理，并返回应答。对后台通知交互时，如果SaaS收到商户的应答不是成功或超时，SaaS认为通知失败，SaaS会通过一定的策略定期重新发起通知。尽可能提高通知的成功率，但不保证通知最终能成功。(通知频率为15/15/30/180/1800/1800/1800/1800/3600，单位：秒)

如果异步通知的状态与查询接口的返回存在不一致，以查询接口的返回为准。

请求参数(O-非必传 ,M-必传,C-选传)

参数	参数名称	类型	参数说明	可空
agent_no	服务商编号	String		M
merch_no	海科商户编号	String	海科商户编号	M
total_amount	交易金额	String	上送银联的交易金额（单位：元）	M
market_subsidy_amount	营销补贴金额	String	服务商补贴金额（单位：元）	O
ledger_type	分账类型	String	不传默认不分账 REALTIME_SETTLE：实时分账 DELAY_SETTLE：异步分账(预留功能)	O
ledger_info	分账信息	JSONARRAY	分账信息组， ledger_type= REAL_TIME时，该参数必填	O
pay_type	支付类型	String	WX：微信支付 ALI：支付宝支付 UNIONQR：云闪付	M
pay_mode	支付方式	String	NATIVE：扫码支付 JSAPI：JSAPI支付 BARPAY：付款码支付	M
out_trade_no	服务商支付订单号	String		M
trade_no	海科支付订单号	String		M
voucher_no	支付凭证号	String	支付成功时有值	M
sign	签名	String	签名	M

分账信息:ledger_info

参数	参数名称	类型	参数说明	样例	可空
receive_no	收账商户编号(海科商户编号)	String	收账商户编号(海科商户编号)		M
amt	分账金额	String	分账金额（单位：元）	20	M

pay_type=WX时返回:

参数	参数名称	类型	参数说明	可空
appid	公众账号ID	String	调用接口提交的公众账号 ID	M
openid	用户标识	String	appid 下的唯一标识	M
bank_type	付款银行	String	银行类型。采用字符串类型的银行识	M
cash_fee	现金支付金额	int	订单现金支付金额	M
settlement_total_fee	应结订单金额	int	当订单使用了免充值型优惠券后返回该参数，应结订单金额=订单金额-免充值优惠券金额。	M
coupon_fee	代金券金额	String	“代金券”金额<=订单金额，订单金额-“代金券”金额=现金支付金额	M
promotion_detail	优惠功能	JSON	优惠功能信息	M

微信优惠功能promotion_detail:

参数	参数名称	类型	参数说明	样例	可空
promotion_id	券ID	String	券或者立减优惠id		M
name	优惠名称	String	优惠名称		O
scope	优惠范围	String	GLOBAL- 全场代金券 SINGLE- 单品优惠	SINGLE	O
type	优惠类型	String	COUPON- 代金券，需要走结算资金的充值型代金券,（境外商户券币种与支付币种一致） DISCOUNT- 优惠券，不走结算资金的免充值型优惠券，（境外商户券币种与标价币种一致	DISCOUNT	O
amount	优惠券面额	int	用户享受优惠的金额（优惠券面额=微信出资金额+商家出资金额+其他出资方金额）	5	O
activity_id	活动 ID	String	在微信商户后台配置的批次 ID	931386	O
wxpay_contribute	微信出资	int	特指由微信支付商户平台创建的优惠，出资金额等于本项优惠总金额，单位为分	0	O
merchant_contribute	商户出资	int	特指商户自己创建的优惠，出资金额等于本项优惠总金额，单位为分	0	O
other_contribute	其他出资	int	其他出资方出资金额，单位为分	5	O
goods_detail	单品列表	JSONArray	单品信息		O

微信单品列表:goods_detail

参数	参数名称	类型	参数说明	样例	可空
goods_id	商品编码	String(32)	由半角的大小写字母、数字、中划线、下划线中的一种或几种组成		M
goods_remark	商品备注	String(128)	goods_remark为备注字段，按照配置原样返回，字段内容在微信后台配置券时进行设置。		O
discount_amount	商品优惠金额	int	单品的总优惠金额，单位为：分		M
quantity	商品数量	int	用户购买的数量		M
price	商品价格	int	单位为：分。如果商户有优惠，需传输商户优惠后的单价(例如：用户对一笔100元的订单使用了商场发的纸质优惠券100-50，则活动商品的单价应为原单价-50)	528800	M

pay_type=ALI时返回:

参数	参数名称	类型	参数说明	可空
receipt_amount	实收金额	String	实收金额	M
buyer_pay_amount	买家付款的金额	String	买家付款的金额	O
buyer_user_id	买家在支付宝的用户id	String	买家在支付宝的用户 id	M
fund_bill_list	交易支付使用的资金渠道	JSONARRAY	交易支付使用的资金渠道	M
mdiscount_amount	商家优惠金额	String	商家优惠金额	O
discount_amount	平台优惠金额	String	平台优惠金额	O
discount_goods_detail	单品券优惠的商品优惠信息	String	本次交易支付所使用的单品券优惠的商品优惠信息	O
voucher_detail_list	优惠信息	JSONARRAY	本交易支付时使用的所有优惠券信息	O

支付宝交易支付使用的资金渠道:fund_bill_list

参数	参数名称	类型	参数说明	可空
fund_channel	交易使用的资金渠道	String(32)	交易使用的资金渠道	M
bank_code	银行卡支付时的银行代码	String(10)	银行卡支付时的银行代码	O
amount	该支付工具类型所使用的金额	Double	该支付工具类型所使用的金额	M
real_amount	渠道实际付款金额	Double	渠道实际付款金额	M
fund_type	渠道所使用的资金类型	String(32)	目前只在资金渠道 (fund_channel) 是银行卡渠道(BANKCARD)的情况下才返回该信息: DEBIT_CARD:借记卡 CREDIT_CARD:信用卡 MIXED_CARD:借贷合一卡	O

支付宝优惠信息:voucher_detail_list

参数	参数名称	类型	参数说明	可空
id	券id	String(32)	券id	M
name	券名称	String(64)	券名称	M
type	券类型	String(32)	当前有三种类型： ALIPAY_FIX_VOUCHER - 全场代金券 ALIPAY_DISCOUNT_VOUCHER-折扣券 ALIPAY_ITEM_VOUCHER-单品优惠注：不排除将来新增其他类型的可能，商家接入时注意兼容性避免硬编码	M
amount	优惠券面额	Double	它应该会等于商家出资加上其他出资方出资	M
merchant_contribute	商家出资	Double	商家出资（特指发起交易的商家出资金额）	O
other_contribute	其他出资方出资金额	Double	其他出资方出资金额，可能是支付宝可能是品牌商，或者其他方，也可能是他们的一起出资	O
memo	优惠券备注信息	String(256)	优惠券备注信息	O
template_id	券模板 id	String(64)	券模板 id	O
other_contribute_detail	优惠券的其他出资方明细	String(32)	优惠券的其他出资方明细	O
contribute_type	出资方类型	String(32)	出资方类型，如品牌商出资、支付宝平台出资等	M
contribute_amount	出资方金额	Double	出资方金额	M
purchase_buyer_contribute	券实际购买付款金额	Double	如果使用的这张券是用户购买的，则该字段代表用户在购买这张券时用户实际付款的金额	O
purchase_merchant_contribute	券实际购买时商户优惠金额	Double	如果使用的这张券是用户购买的，则该字段代表用户在购买这张券时商户优惠的金额	O
purchase_ant_contribute	券实际购买时平台优惠金额	Double	如果使用的这张券是用户购买的，则该字段代表用户在购买这张券时平台优惠的金额	O

pay_type=UNIQR时返回:

参数	参数名称	类型	参数说明	样例	可空
couponInfo	优惠信息	JSONARRAY	优惠信息		O

云闪付优惠信息couponInfo

参数	参数名称	类型	参数说明	样例	可空
spnsrId	出资方	String	银联作为出资方：固定填写00010000；付款方作为出资方：填写 8 位付款方机构代码商户作为出资方：填写 15 位商户代码(银联商户号)。		M
offstAmt	优惠金额	String	以分为单位		M

请求示例:

{
    "agent_no": "IS88888888",
    "merch_no": "83388888888",
    "pay_type": "ALI",
    "out_trade_no": "123456789",
    "trade_no": "AL88888888",
    "voucher_no": "AL88888888",
    "receipt_amount": "88.88",
    "buyer_pay_amount": 8.88,
    "fund_bill_list": [
        {
                "fund_channel": "ALIPAYACCOUNT",
                "amount": 10,
                "real_amount": 11.21
        }
    ],
    "buyer_user_id": "2088101117955611",
    "mdiscount_amount": "88.88",
    "discount_amount": "88.88",
    "discount_goods_detail": "[{\"goods_id\":\"STANDARD1026181538\",\"goods_name\":\"雪碧\",\"discount_amount\":\"100.00\",\"voucher_id\":\"2015102600073002039000002D5O\"}]",
    "voucher_detail_list": [
        {
                "id": "2015102600073002039000002D5O",
                "name": "XX超市5折优惠",
                "type": "ALIPAY_FIX_VOUCHER",
                "amount": 10,
                "merchant_contribute": 9,
                "other_contribute": 1,
                "memo": "学生专用优惠",
                "template_id": "20171030000730015359000EMZP0",
                "purchase_buyer_contribute": 2.01,
                "purchase_merchant_contribute": 1.03,
                "purchase_ant_contribute": 0.82
        }
    ],
    "sign": "1032A57E96E4048B27EC2A5C3CE5E663"
}

返回参数说明:

参数	参数名称	类型	参数说明	样例	可空
result	接收结果	String	接收成功后返回“SUCCESS”	SUCCESS	M

返回示例:

{
    "result": "SUCCESS"
}

文档更新时间: 2024-01-12 16:05 作者：陈文