聚合收银台订单创建参数

拉卡拉2.0 6天前 ( 11-20 20:01 ) 26

调用地址

注:因银网联测试环境问题,微信钱包在测试环境下无法下单完成支付,下单后提示”sub mch id与sub appid不匹配”报错即可。

自2024年1月16日起,请通过以下接口进行接入:

使用HTTP协议,POST方式提交。

URL(测试环境外网):https://test.wsmsd.cn/sit/api/v3/ccss/counter/order/special_create

URL(生产环境):https://s2.lakala.com/api/v3/ccss/counter/order/special_create

商户需在微信商家后台配置以下支付域名(原支付目录),2023 年 9 月后入网的商户可忽略此配置

生产环境订单域名:pay.lakala.com

测试环境订单域名:pay.wsmsd.cn

请求参数

字段名是否必输类型长度字段描述示例
out_order_noMString32商户订单号12345678
merchant_noMString32银联商户号822100041120005
vpos_idCString32交易设备标识,进件返回接口中的termId字段,非API接口进件请联系业务员。462621830268882944
channel_idCString32渠道号 (一般不用)24865454154
total_amountMlong12订单金额,单位:分200
order_efficient_timeMString14订单有效期 格式yyyyMMddHHmmss,最大支持下单时间+7天20210803141700
notify_urlCString128订单支付成功后商户接收订单通知的地址 http://xxx.xxx.com
support_cancelCint1是否支持撤销 默认 0 不支持
busi_mode为“PAY-付款”不支持 撤销
(0 不支持 1支持)
support_refundCint1是否支持退款 默认0 不支持(0 不支持 1支持)
support_repeat_payCint1是否支持“多次发起支付” 默认0 不支持(0 不支持 1支持)
out_user_idCString64发起订单方的userId,归属于channelId下的userId
callback_urlCString128客户端下单完成支付后返回的商户网页跳转地址。
order_infoMString64订单标题,在使用收银台扫码支付时必输入,交易时送往账户端
term_noCString32结算终端号,合单场景必输该字段
split_markCString2合单标识,“1”为合单,不填默认是为非合单
settle_typeCString4

结算类型(非合单) (“0”或者空,常规结算方式)
  
注意:该字段会影响结算方式,慎用。(调用拉卡拉分账接口,分账模式为标记分账时需必传1)


out_split_infoCList<>
拆单信息
合单标识为“1”时必传该字段。,详细字段见out_split_info字段说明

counter_paramCString1024json字符串 收银台展示参数{\“pay_mode\“ : \“ALIPAY\“} ,指定支付方式为支付宝
ALIPAY:支付宝
WECHAT:微信
UNION:银联云闪付
CARD:POS刷卡交易
LKLAT:线上转帐
QUICK_PAY:快捷支付
EBANK:网银支付
UNION_CC:银联支付

BESTPAY:翼支付
HB_FQ:花呗分期
UNION_FQ:银联聚分期

ONLINE_CARDLESS:线上外卡

JDBT:京东白条

ALIPAY_HK:支付宝香港钱包支付

若要指定支付方式为支付宝传参格式:
{\“pay_mode\“ : \“ALIPAY\“}

counter_remark
CString128收银台备注
busi_type_paramCString256业务类型控制参数,jsonStr格式[{\“busi_type\“:\“UPCARD\“,\“params\“:{\“crd_flg\“:\“CRDFLG_D|CRDFLG_C|CRDFLG_OTH\“}},{\“busi_type\“:\“SCPAY\“,\“params\“:{\“pay_mode\“:\“ALIPAY\“,\“crd_flg\“:\“CRDFLG_D\“}}]
说明:UPCARD-刷卡,SCPAY-扫码,CRDFLG_D-借记卡,CRDFLG_C-贷记卡,CRDFLG_OTH-不明确是借记卡还是贷记卡
pay_mode送参说明:ALIPAY-支付宝,WECHAT-微信,UNION-银联二维码,DCPAY-数字货币,BESTPAY-翼支付

说明:一旦使用该字段,则增加限制,必须在指定限制范围内支付。比如,只配置”busi_type”:”UPCARD”的参数而不配置”busi_type”:”SCPAY”的参数,则只能通过刷卡而不能通过扫码完成支付

sgn_infoClist<>
签约协议号列表(字符串)[“1234”,”2345”],不支持空列表[];列表中签约协议号不能为空;列表中签约协议号不能重复
product_id
CString6指定产品编号 (200809:线上外卡收银台) 注意:该字段默认不需要指定,特殊场景下使用,慎用
goods_markCString
商品信息标识 (1:含商品信息,不填默认不含商品信息)
goods_fieldCString2商品信息域(good_mark送1时该域必填,否则不送。只有线上外卡业务上送该字段) 详细字段见goods_field字段说明
order_scene_fieldCObject
2订单场景域,特殊场景下需要上送 详细字段见order_scene_field字段说明
age_limitCString10:不限年龄;1:年龄限制
repeat_pay_auto_refundCString1

0:重复支付后不自动退货;1:重复支付后自动退货 (默认不送为0),注意:请详细了解字段场景后上送

需注意互斥条件:repeat_pay_auto_refund选择“1”重复支付后自动退货后,repeat_pay_notify仅支持选择“0”重复支付订单不通知


repeat_pay_notifyCString10:重复支付订单不通知;1:重复支付订单通知 (默认不送为0)
close_order_auto_refundCString10:不自动退货;1:关闭订单后支付成功触发自动退货 (默认不送为0)注意:请详细了解字段场景后上送
shop_nameCString64网点名称
inte_routingCString2智能路由下单标识 1-是 0-否(默认不送为0)备注:需要在收银台管控台配置聚合收银台小程序白名单
discount_codeCString64优惠码(目前供线上国补下单使用)
electrical_equipment_categoryC
String
128支付宝优惠码(目前优惠码的地区:浙江、江苏、上海、福建、重庆)
trade_biz_tpCString16线上业务通道类型具体类型见补充枚举


out_split_info字段说明

字段名中文名称是否必填类型说明
out_sub_order_no外部子订单号MString(32)商户子订单号
merchant_no商户号MString(32)拉卡拉分配的银联商户号
term_no终端号MString(32)拉卡拉分配的业务终端号
amount金额MString(12)单位分,整数型字符
settle_type结算类型(合单)CString(4)“0”或者空,常规结算方式

说明:

 1)拆单信息域中商户号不可重复;

 2)交易层订单金额必须是拆单信息域中各个子单的金额汇总之和;

 3)对拆单信息域中每个结算商户号和终端号的权限交易都必须通过,其中一个校验失败,则交易中止,失败返回;

 4)拆单域中子单条数最少两条、最多20条,否则拒绝。

goods_field字段说明

字段名中文名称是否必填类型说明
goods_amt商品单价MLong单位:分
goods_num商品数量MInteger
goods_pricing_unit商品计价单位MString(8)1-箱 2-件 3-瓶 4-个
goods_name商品名称MString(128)
te_platform_type交易电商平台类型MString(2)1-境内平台 2-境外平台
te_platform_name交易电商平台名称MString(256)
goods_type交易商品类型MString(8)1:服饰箱包
2:食品药品
3:化妆品
4:电子产品
5:日用家居
7:航空机票
8:酒店住宿
9:留学教育
10:旅游票务
11:国际物流
12:国际租车
13:国际会议
14:软件服务
15:医疗服务
16:通讯
17:休闲娱乐

order_scene_field字段说明

字段名中文名称是否必填类型说明
order_scene_type订单场景类型MString(16)订单场景类型(按下述定义场景送值)

HB_FQ:花呗分期场景

KL_FQ:考拉分期场景

scene_info订单场景信息CString(1024)订单场景信息(json字符串格式),不同的订单场景类型需要上送的结构不一样(详见具体场景)

HB_FQ场景

scene_info字段说明

字段名中文名称是否必填类型说明
hbFqNum花呗分期期数MString支付宝花呗分期必送字段: 花呗分期数 3:3期 6:6期 12:12期
hbFqSellerPercent卖家承担手续费比例MString支付宝花呗分期必送字段: 卖家承担手续费比例,间连模式下只支持传0。

JDBT场景

scene_info字段说明

字段名中文名称是否必填类型说明
LOCKPLAN

String
->jdbtFqNum京东白条分期期数MString京东白条分期数 3:3期,6:6期,12:12期 ,24:24期

trade_biz_tp字段说明

拉卡拉业务种类编码编码含义
100001虚拟商品购买
100002预付费类账户充值
100003实物消费
100004航空商旅消费
100005生活及商业服务消费
100006其他商户消费
100007招投标保证金支付
100008境外商品购买
100A01实物商品租赁
100A03单用途预付卡充值
100A06商业服务消费
100A05航旅交通服务
100A07生活服务消费
100A08个人经营服务
110001公共事业缴费
110002教育医疗缴费
110003政府服务缴费
110004公益捐款
110005农林牧副渔收购
110006政府服务
110007薪资发放
110008其他公共服务
110A01水电煤气缴费
110A02税费缴纳
110A03非营利性教育缴费
110A05罚款缴纳
110A06路桥通行缴费
110A07邮政缴费
110A08电视账单缴费
110A09话费账单缴费
110A10宽带账单缴费
110A13财政非税收入
110A14营利性教育培训
110A15公共交通
110A16急救救援
110A17物业缴费
110A18国库经收
110A19供暖费缴纳
110A20废弃物处理费用缴纳
110A21租金缴纳
110A22会员费用缴纳
110A23税费退还
120001其他金融付款
120002其他金融收款
120003基金购买
120004保险选购
120005投资理财
120006信贷偿还
120007信用卡还款转出
120008基金赎回/返还/分红
120009保险理赔/分红
120010投资理财赎回/返还/分红
120011信贷发放
120012信用卡还款转入
120A01基金理财产品申购
120A02基金理财产品认购
120A03非投资型保险费用缴纳
120A05商业众筹
120A06贵金属投资买入
120A07基金理财产品赎回
120A08基金理财产品到期返还
120A09认/申购失败返还
120A10基金理财产品分红
120A11保险理赔或退费
120A12保险红利发放或给付发放
120A13贵金属投资买出
120A16融资租赁
120A19投资型保险费用缴纳
120A20小贷公司贷款还款
120A21保单贷款发放
120A22其他保险资金代发
130001支付账户充值
130002支付账户回提
130003银行账户转账转出
130004其他账户充值
130005银行账户转账转入
130006其他账户回提
130A03向他人支付账户转账
130A05预付卡赎回 -个人赎回
130A06预付卡赎回-单位赎回
130A08测试验证资金
130A09薪酬福利发放
130A10代发货款
140001商户结算-交易资金结算
140002营销返现
140003其他商户结算
140A02预付卡商户结算
140A03商户收单资金提现
150A01资金归集
200000对公业务



请求样例

{
   "req_data": {
       "out_order_no": "KFPT20220714160009228907288",
       "merchant_no": "8222900701106PZ",
       "vpos_id": "587305941625155584",
       "channel_id": "2021052614391",
       "total_amount": "1",
       "order_efficient_time": "20220714170009",
       "notify_url": "http://run.mocky.io/v3/b02c9448-20a2-4ff6-a678-38ecab30161d",
       "support_cancel": "0",
       "support_refund": "1",
       "support_repeat_pay": "1",
       "busi_type_param": "[{\"busi_type\":\"UPCARD\",\"params\":{\"crd_flg\":\"CRDFLG_D|CRDFLG_C|CRDFLG_OTH\"}},{\"busi_type\":\"SCPAY\",\"params\":{\"pay_mode\":\"WECHAT\",\"crd_flg\":\"CRDFLG_D\"}}]",
       "counter_param": "{\"pay_mode\":\"ALIPAY\"}",
       "out_user_id": "",
       "order_info": "自动化测试",
       "extend_info": "自动化测试",
       "callback_url": ""
   },
   "version": "3.0",
   "req_time": "20220714160009"}
复制

返回参数

字段名是否必输类型长度字段描述示例
merchant_noMString32
银联商户号
channel_idMString32

out_order_noMString32商户订单号
order_create_timeMString32创建订单时间订单系统创建订单的时间,格式yyyyMMddHHmmss
order_efficient_timeMString32订单有效截至时间格式yyyyMMddHHmmss
pay_order_noMString64平台订单号21070211012001970631000383039
total_amountMlong12订单金额,单位:分200
counter_urlMString256收银台地址信息

响应样例

{
   "msg": "操作成功",
   "resp_time": "20210922181057",
   "code": "000000",
   "resp_data": {
       "merchant_no": "8222900701106PZ",
       "channel_id": "25",
       "out_order_no": "KFPT20220714160009228907288",
       "order_create_time": "20210922181056",
       "order_efficient_time": "20210803141700",
       "pay_order_no": "21092211012001970631000488056",
       "counter_url": "http://q.huijingcai.top/b/pay?merchantNo=8221210594300JY&merchantOrderNo=08F4542EEC6A4497BC419161747A92FQ&payOrderNo=21092211012001970631000488056"
   }
}
复制

返回码code一览表

msgcode
成功000000


The End