概要描述:

除付款码支付场景以外，服务商系统先调用该接口在海科平台预下单，后再按Native、JSAPI等不同场景获取不同的返回值进行支付。

请求URL:

  • 测试环境：/unifierorder

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

参数 参数名称 类型 参数说明 样例 可空
agent_no 服务商编号 String M
merch_no 海科商户编号 String 海科商户编号 M
pay_type 支付类型 String WX：微信支付
ALI：支付宝支付
UNIONQR：云闪付		 M
pay_mode 支付方式 String NATIVE：扫码支付
JSAPI：JSAPI支付		 M
appid 公众账号ID String 微信支付时使用：微信分配的公众账号 ID C
openid 用户标识 String pay_mode=JSAPI时此参数必传 C
channel_no 渠道商商户号 String 微信或者支付宝时使用：
微信分配的渠道商ID;支付宝分配的pid		 C
sub_mch_id 报备商户编号 String 微信或者支付宝时使用 C
out_trade_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时，该参数必填 C
notify_url 异步通知地址 String 交易成功异步通知地址 O
sign 签名 String 签名 M
wx_native_params 微信原生请求参数 JSON pay_type=WX时该参数选填 C
ali_native_params 支付宝原生请求参数 JSON pay_type=ALI时该参数选填 C
uniqr_native_params 云闪付原生请求参数 JSON pay_type=UNIQR时该参数选填 C
分账信息:ledger_info
参数 参数名称 类型 参数说明 样例 可空
receive_no 收账商户编号(海科商户编号) String 收账商户编号(海科商户编号) M
amt 分账金额 String 分账金额（单位：元） 20 M
微信原生请求参数:wx_native_params
参数 参数名称 类型 参数说明 样例 可空
goods_tag 微信订单优惠标记 String(32) 微信订单优惠标记，代金券或立减优惠功能的参数 O
device_info 微信设备号 String(32) 终端设备号(门店号或收银设备ID)，注意：PC网页或JSAPI支付请传”WEB” O
detail 微信商品详情 JSON 微信单品优惠功能 O
微信单品优惠功能:detail
参数 参数名称 类型 参数说明 样例 可空
cost_price 订单原价 int 1.商户侧一张小票订单可能被分多次支付，订单原价用于记录整张小票的交易金额。
2.当订单原价与支付金额不相等，则不享受优惠。
3.该字段主要用于防止同一张小票分多次支付，以享受多次优惠的情况，正常支付订单不必上传此参数。		 608800 O
receipt_id 商品小票ID String(32) 商家小票ID O
goods_detail 单品列表 JSONArray 单品信息，使用Json数组格式提交 O
微信单品列表:goods_detail
参数 参数名称 类型 参数说明 样例 可空
goods_id 商品编码 String(32) 由半角的大小写字母、数字、中划线、下划线中的一种或几种组成 M
wxpay_goods_id 微信侧商品编码 String(32) 微信支付定义的统一商品编号（没有可不传） O
goods_name 商品名称 String(256) 商品的实际名称 O
quantity 商品数量 int 用户购买的数量 M
price 商品单价 int 单位为：分。如果商户有优惠，需传输商户优惠后的单价(例如：用户对一笔100元的订单使用了商场发的纸质优惠券100-50，则活动商品的单价应为原单价-50) 528800 M
支付宝原生请求参数:ali_native_params
参数 参数名称 类型 参数说明 样例 可空
operator_id 商户操作员编号 String(28) 商户操作员编号。新当面资金授权场景必填。 yx_001 C
store_id 商户门店编号 String(32) 商户门店编号。新当面资金授权场景必填。 NJ_001 C
terminal_id 商户机具终端编号 String(32) 商户机具终端编号 NJ_T_001 C
goods_detail 订单包含的商品列表信息 JSONArray 订单包含的商品列表信息，json数组格式。 O
extend_params 业务扩展参数 JSON 业务扩展参数 O
支付宝订单包含的商品列表信息:goods_detail
参数 参数名称 类型 参数说明 样例 可空
goods_id 商品编号 String(32) apple-01 M
goods_name 商品名称 String(256) 商品的实际名称 M
quantity 商品数量 int 用户购买的数量 M
price 商品单价 int 商品单价，单位为元 2000 M
goods_category 商品类目 String（24） 商品类目 34543238 O
categories_tree 商品类目树 String（128） 商品类目树，从商品类目根节点到叶子节点的类目id组成，类目id值使用 分割
body 商品描述信息 String(1000) 商品描述信息 O
show_url 商品的展示地址 String(400) 商品的展示地址 O
支付宝业务扩展参数:extend_params
参数 参数名称 类型 参数说明 样例 可空
sys_service_provider_id 系统商编号 String(64) 该参数作为系统商返佣数据提取的依据，请填写系统商签约协议的PID O
hb_fq_num 花呗分期数 String 使用花呗分期要进行的分期数 O
hb_fq_seller_percent 花呗分期数手续费 String 使用花呗分期需要卖家承担的手续费比例的百分值，传入100 代表100% O
industry_reflux_info 行业数据回流信息 String(512) 行业数据回流信息, 详见：地铁支付接口参数补充说明 O
card_type 卡类型 String(32) 卡类型 O
云闪付原生请求参数:uniqr_native_params
参数 参数名称 类型 参数说明 样例 可空
pnrInsIdCd 银联服务商机构号 String 银联服务商机构号，参加银联云闪付活动时上送 O
acqAddnData 收款方附加数据 JSON 收款方附加数据 O
(银联二维码)收款方附加数据: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

请求示例:

{
    "agent_no": "IS88888888",
    "merch_no": "83388888888",
    "pay_type": "ALI",
    "pay_mode": "NATIVE",
    "out_trade_no": "123456789",
    "total_amount": "1",
    "sign": "5F154E14FDC459ED5DF628B56F61A609"
}

返回参数说明:

参数 参数名称 类型 参数说明 样例 可空
result_code 响应码 String 10000代表成功 M
result_msg 响应信息 String M
agent_no 服务商编号 String M
merch_no 海科商户编号 String 海科商户编号 M
pay_type 支付类型 String WX：微信支付
ALI：支付宝支付
UNIONQR：云闪付		 M
pay_mode 支付方式 String NATIVE：扫码支付
JSAPI：JSAPI支付		 M
out_trade_no 服务商支付订单号 String M
trade_no 海科支付订单号 String M
sign 签名 String 签名 M

pay_type=WX时返回:

参数 参数名称 类型 参数说明 样例 可空
code_url 二维码链接 String pay_mode=NATIVE时返回,可将该参数值生成二维码展示出来进行扫码支付 C
wc_pay_data 微信JS 调用数据 String pay_mode=JSAPI时返回，用于执行 JS 支付 C

pay_type=ALI时返回:

参数 参数名称 类型 参数说明 样例 可空
ali_qr_code 二维码链接 String pay_mode=NATIVE时返回,可将该参数值生成二维码展示出来进行扫码支付 C
ali_trade_no 支付宝交易号 String pay_mode=JSAPI时返回，用于执行 JS 支付 C

pay_type=UNIQR时返回:

参数 参数名称 类型 参数说明 样例 可空
uniqr_qr_code 二维码链接 String pay_mode=NATIVE时返回,可将该参数值生成二维码展示出来进行扫码支付 C
uniqr_redirect_url 云闪付JS String pay_mode=JSAPI时返回，用于执行 JS 支付 C

返回示例:

{
    "agent_no": "IS88888888",
    "merch_no": "83388888888",
    "pay_type": "ALI",
    "pay_mode": "NATIVE",
    "out_trade_no": "123456789",
    "trade_no": "AL88888888",
    "ali_qr_code": "https://qr.alipay.com/bax00449ihxp9epamcwn50c2",
    "return_code": "10000",
    "return_msg": "成功",
    "sign": "1032A57E96E4048B27EC2A5C3CE5E663"
}
文档更新时间: 2024-04-16 13:29   作者：陈文