被扫支付API

业务功能
收银员使用扫码设备读取用户微信/支付宝/云闪付等APP付款码以后，二维码或条码信息传送至商户收银台，由商户收银台或者商户后台调用该接口发起支付对用户进行收款。
交互模式
请求：后台请求交互模式
返回结果：后台请求交互模式+后台通知交互模式
测试url：
http://47.95.131.62:8080/api/v1/pay/uniqr/passivepay

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

参数	参数名称	类型	参数说明	样例	可空
merch_no	商户编号	String	商户在SaaS平台的编号	a10253390	M
out_trade_no	服务商交易订单号	String	服务商的交易订单编号（同一服务商下唯一）	161018121614000624679888	M
total_amount	订单金额	String	订单总金额，以元为单位	100	M
ledger_type	分账类型	String	不传默认不分账 REALTIME_SETTLE：实时分账 DELAY_SETTLE：延时分账	如果上送此字段，需要保证服务商分账业务已开通,否则不允许交易	O
ledger_relation	分账交易关系组	JSONArray	分账交易关系组(v1.18增加)	如果上送此字段，需要保证服务商分账业务已开通,否则不允许交易	O
notify_url	通知地址	String	支付成功后的通知地址	http://test.mdun.cn/jd/pay/notice	O
auth_code	付款码	String	付款码	130022933989643883	M
sn	厂商终端号	String	(v1.05增加)		O
pn	SAAS终端号	String	259号文要求上送，通过商户终端绑定接口获得		M
remark	交易备注	String	(v1.05增加)		O
subsidy_info	手续费补贴信息	JSON	1、需要保证服务商补贴业务已开通,否则不允许交易 2、手续费补贴费率、手续费执行费率和手续费补贴金额三选一进行上送		O
market_subsidy_agent_no	营销补贴代理商编号	Sting	1、涉及到多营销主体补贴时该字段必填。 2、运营提供营销补贴代理商编号		C
market_subsidy_info	营销补贴信息	JSONArray	营销补贴信息详情，单笔交易支持多个补贴方且单笔交易总补贴金额需小于订单金额。注意：服务商需开通营销补贴功能，且补贴金额需小于等于营销补贴账户余额		O
acq_addn_data	收款方附加数据	JSON	涉及单品营销，交易需要在此上送商品信息		O
termid	银联终端号	String	银联交易上送终端号		O
pnrInsIdCd	银联服务商机构号	String	银联服务商机构号，参加银联云闪付活动时上送	11111111	O

手续费补贴信息subsidy_info 字段说明

参数	参数名称	类型	参数说明	样例	可空
fee_subsidy_agent_no	手续费补贴代理商编号	Sting	1、涉及到多营销主体补贴时该字段必填。2、运营提供手续费补贴代理商编号		C
fee_subsidy_party	手续费补贴方	String	1、手续费补贴方联系商务或者运营获取		M
fee_subsidy_rate	手续费补贴费率	object	1、手续费补贴费率、手续费执行费率和手续费补贴金额三选一进行上送 2、手续费补贴费率只能小于（可以等于）商户该笔交易手续费费率 3、传递费率为一组费率值 4、费率单位：费率值0.38%，则上送0.38 ，封顶金额以元为单位：1.5元，则上送1.5	{"union_debit_rate":"银联二维码借记卡费率","union_debit_max":"银联二维码借记卡手续费封顶","union_credit_rate":"银联二维码贷记卡费率","union_mix_rate":"银联二维码1000元以下包括1000元费率"}	C
fee_execute_rate	手续费执行费率	object	1、手续费补贴费率、手续费执行费率和手续费补贴金额三选一进行上送 2、手续费执行费率只能小于（不可以等于）商户该笔交易手续费费率 3、商户该笔交易费率减去手续费执行费率就是该笔交易补贴费率 4、传递费率为一组费率值 5、费率单位：费率值0.38%，则上送0.38 ，封顶金额以元为单位：1.5元，则上送1.5	{"union_debit_rate":"银联二维码借记卡费率","union_debit_max":"银联二维码借记卡手续费封顶","union_credit_rate":"银联二维码贷记卡费率","union_mix_rate":"银联二维码1000元以下包括1000元费率"}	C
fee_subsidy_amount	手续费补贴金额	String	1、手续费补贴费率、手续费执行费率和手续费补贴金额三选一进行上送 2、手续费补贴金额不能大于手续费金额（可以等于手续费金额） 3、传递补贴手续费金额大于该笔手续费金额，按照该笔交易实际手续费金额补贴 4、金额以元为单位：1.5元，则上送1.5		C

营销补贴信息:market_subsidy_info

参数	参数名称	类型	参数说明	样例	可空
party	营销补贴账户	String	在海科开通的营销补贴账户号		M
amt	营销补贴金额	String	营销补贴金额（单位：元）	20	M

分账关系组:ledger_relation

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

收款方附加数据:acq_addn_data

参数	参数名称	类型	参数说明	样例	可空
orderInfo	订单信息	JSON	订单明细内容，如订单标题、订单描述等		O
goodsInfo	商品信息	JSONArray	商品明细内容		O

订单信息:orderInfo

参数	参数名称	类型	参数说明	可空
title	标题	String	标题	M
description	订单描述	String	订单描述	O
dctAmount	可优惠金额	String	当前订单可以参与优惠计算的金额	O
addnInfo	附加信息	String	内容自定义	O

商品信息:goodsInfo

参数	参数名称	类型	参数说明	可空
id	标题	String	标题	M
name	商品名称	String	订单描述	M
price	商品单价	String	以分为单位	M
quantity	商品数量	String		M
category	商品类目	String		O
addnInfo	附加信息	String		O

请求示例:

{
    "accessid": "cpostest",
    "merch_no": "88888888",
    "out_trade_no": "2020032514544954",
    "total_amount": "12",
    "auth_code": "6227654105800757320",
    "notify_url": "http://47.95.131.62:8080/saas/trade/success/notice/test",
    "sn": "WSY196",
    "pn": "S0000053",
    "remark": "备注",
    "ledger_relation": [
        {
            "receive_no": "833584358120001",
            "amt": "1"
        }
    ],
    "sign": "18CDDAFF8BC73A65782A75518B4E5FE9"
}

返回参数:

参数	参数名称	类型	参数说明	样例	可空
out_trade_no	服务商交易订单号	String	服务商的交易订单编号	161018121614000624679888	M
trade_no	交易订单号	String	SaaS平台的交易订单编号		M
channel_trade_no	凭证条码订单号	String	凭证条码订单号(v1.24增加)	161018121614000624679888	M
total_amount	订单金额	String	订单总金额，以元为单位	100	M
accept_status	交易受理状态	String	1：交易已受理 2：交易受理失败本字段只是交易的受理状态，并非支付结果，仅表示当前交易在银联方是否已经受理。最终支付结果需要调用交易查询接口或者等候支付成功的异步通知	1	M
error_code	交易错误码	String	交易错误码	80002	O
error_msg	交易错误信息	String	交易的错误信息	授权码过期请刷新	O

返回示例:

正确：
{
    "out_trade_no": "20190506165810632",
    "total_amount":"0.01",
    "trade_no": "UN190506165839044000252609",
    "accept_status": 1,
    "return_code": 10000,
    "sign": "6985EBB531B79496D5542A17C9D8EECD"
}
错误：
{
    "return_code": 99999,
    "return_msg": "银联风险受限[3300023]",
    "sign": "91176AF716B83CA3E79D21647F03A06E"
}

文档更新时间: 2023-06-16 13:09 作者：admin