被扫支付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
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
分账关系组: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"
}
文档更新时间: 2025-02-11 11:07   作者：admin