主扫支付API

业务功能
初始化扫码请求，通过该请求生成二维码来进行扫码支付。
交互模式
请求：后台请求交互模式
返回结果+通知：后台请求交互模式+后台通知交互模式
测试url：
http://47.95.131.62:8080/api/v1/pay/uniqr/activepay

请求参数(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
sn 厂商终端号 String (v1.05增加) O
pn SAAS终端号 String 若使用海科商户后台或绑定海科语音设备则上送pn值，pn值通过终端绑定接口获得 O
termid 银联终端号 String 银联终端号，参加银联云闪付活动时上送 11111111 O
pnrInsIdCd 银联服务商机构号 String 银联服务商机构号，参加银联云闪付活动时上送 11111111 O
acq_addn_data (银联二维码)收款方附加数据 JSON 涉及扫码点餐业务，交易需要在此上送商品信息 O
remark 交易备注 String (v1.05增加) 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（8） 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 s 手续费补贴金额 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": "20200325161831291",
    "total_amount": "30",
    "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": "CC213C22BE87F1878C0EEE82D0C81CF9"
}

返回参数:

参数 参数名称 类型 参数说明 样例 可空
qr_code 支付二维码地址 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": "20200325161831291",
    "channel_trade_no": "010920032516181297686MC",
    "trade_no": "UN200325161840148118932261",
    "qr_code": "https://qr.95516.com/00010000/01018341868502552872095120910138",
    "total_amount": "30",
    "return_code": 10000,
    "sign": "B500DF8F2765C4B85BA75DF19842B24E"
}
文档更新时间: 2023-06-16 13:08   作者：admin