银联js支付API

业务功能
服务商通过银联云闪付打开支付页面，然后调用本接口进行下单，下单成功以后重定向到返回的jspay_url进入银联支付页面。
交互模式
请求：后台请求交互模式
返回结果+通知：后台请求交互模式+后台通知交互模式
测试url：
http://47.95.131.62:8080/api/v1/pay/uniqr/jsapi

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

参数	参数名称	类型	参数说明	样例	可空
merch_no	商户编号	String	商户在SaaS平台的编号	a10253390	M
out_trade_no	服务商交易订单号	String	服务商的交易订单编号	161018121614000624679888	M
total_amount	订单金额	String	订单总金额，以元为单位	100	M
userid	银联用户标识	String	银联用户标识，通过获取银联用户标识API接口获取		M
qrCode	二维码地址	String	qrCode必传的值是展示的行业码的内容的值。例如：扫码点餐场景下，qrCode就是传桌面上张贴的二维码的url值		M
userAuthCode	用户授权码	String	用户授权码		M
ledger_flag	分账交易标识	String	分账交易标识(v1.18增加)	参数选填，上送时其值为：Y	O
ledger_type	分账类型	String	不传默认不分账 REALTIME_SETTLE：实时分账 DELAY_SETTLE：延时分账	如果上送此字段，需要保证服务商分账业务已开通,否则不允许交易	O
ledger_relation	分账交易关系组	JSONArray	分账交易关系组(v1.18增加)	ledger_flag为Y时必传	O
notify_url	通知地址	String	支付成功后的通知地址	http://test.mdun.cn/jd/pay/notice	O
sn	厂商终端号	String	(v1.05增加)		O
pn	SAAS终端号	String		若使用海科商户后台或绑定海科语音设备则上送pn值，pn值通过终端绑定接口获得	O
remark	交易备注	String	(v1.05增加)		O
termid	银联终端号	String	银联交易上送终端号		O
pnrInsIdCd	银联服务商机构号	String	银联服务商机构号，参加银联云闪付活动时上送	11111111	O
acq_addn_data	(银联二维码)收款方附加数据	JSON	涉及扫码点餐业务，交易需要在此上送商品信息		O
subsidy_info	手续费补贴信息	JSON	1、需要保证服务商补贴业务已开通,否则不允许交易 2、手续费补贴费率、手续费执行费率和手续费补贴金额三选一进行上送		O
market_subsidy_agent_no	营销补贴代理商编号	Sting	1、涉及到多营销主体补贴时该字段必填。 2、运营提供营销补贴代理商编号		C
market_subsidy_info	营销补贴信息	JSONArray	营销补贴信息详情，单笔交易支持多个补贴方且单笔交易总补贴金额需小于订单金额。注意：服务商需开通营销补贴功能，且补贴金额需小于等于营销补贴账户余额		O
frontUrl	支付成功跳转地址	String	支付成功跳转地址		O
frontFailUrl	支付失败跳转地址	String	支付失败跳转地址		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

(银联二维码)订单信息:orderInfo

参数	参数名称	类型	参数说明	样例	可空
addnInfo	附加信息	String	银联扫码点餐相关参数，格式参考银联侧要求，例如{brandId=值&storeId=值&tableNo=值}		O

请求示例:

{
    "accessid": "cpostest",
    "merch_no": "88888888",
    "out_trade_no": "20190506165735316",
    "total_amount": "0.01",
    "userid": "JcfnDRBtNkZui7PgAzfeW5IltIyu/fGJ0rd4RLbi59kjjKPo6MDsxAGwWPZP",
    "ledger_flag":"Y",
    "ledger_relation":[{
        "receive_no":"88888822",
        "amt":"0.01"
    }...],
    "notify_url": "http://47.95.131.62:8080/saas/trade/success/notice/test",
    "sign": "CBED61197DC7F30AAA41018462463CD7"
}

返回参数:

参数	参数名称	类型	参数说明	样例	可空
jspay_url	银联支付页面地址	String			M
total_amount	订单金额	String	订单总金额，以元为单位	100	M
trade_no	交易订单号	String	SaaS平台的交易订单编号		M
out_trade_no	服务商交易订单号	String	服务商的交易订单编号	161018121614000624679888	M
channel_trade_no	凭证条码订单号	String	凭证条码订单号(v1.24增加)	161018121614000624679888	M

返回示例:

{
    "out_trade_no": "20190506165735316",
    "total_amount": "0.01",
    "trade_no": "UN190506165737179000204421",
    "jspay_url": "https://qr.95516.com/UP02/qrcGtwWeb-web/front/confirmOrder?sessionId=d22f4f93d1ad4cf9a0bb795192275473",
    "return_code": 10000,
    "sign": "3EC9F13E301DE4C1518171430313A585"
}

文档更新时间: 2024-07-05 10:56 作者：admin