支付方式
聚合支付
聚合收银台
收银台订单创建
收银台订单创建
更新时间：2026-04-28 17:42:56
调用地址
注：因银网联测试环境问题，微信钱包在测试环境下无法下单完成支付，下单后提示"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_no	M	String	32	商户订单号	12345678
merchant_no	M	String	32	银联商户号	822100041120005
vpos_id	C	String	32	交易设备标识，进件返回接口中的termId字段，非API接口进件请联系业务员。	462621830268882944
channel_id	C	String	32	渠道号 （一般不用）	24865454154
total_amount	M	long	12	订单金额，单位：分	200
order_efficient_time	M	String	14	订单有效期 格式yyyyMMddHHmmss,最大支持下单时间+7天	20210803141700
notify_url	C	String	128	订单支付成功后商户接收订单通知的地址 http://xxx.xxx.com	
support_cancel	C	int	1	是否支持撤销 默认 0 不支持
busi_mode为"PAY-付款"不支持 撤销	（0 不支持 1支持）
support_refund	C	int	1	是否支持退款 默认0 不支持	（0 不支持 1支持）
support_repeat_pay	C	int	1	是否支持"多次发起支付" 默认0 不支持	（0 不支持 1支持）
out_user_id	C	String	64	发起订单方的userId，归属于channelId下的userId	
callback_url	C	String	128	客户端下单完成支付后返回的商户网页跳转地址。	
order_info	M	String	64	
订单标题，在使用收银台扫码支付时必输入，交易时送往账户端

*该字段暂不支持颜文字、表情符号，比如微笑表情等


term_no	C	String	32	结算终端号,合单场景必输该字段	
split_mark	C	String	2	合单标识，"1"为合单，不填默认是为非合单	
settle_type	C	String	4	
结算类型（非合单） "0"或者空，常规结算方式；如需接拉卡拉分账通需传"1"，商户未开通分账之前切记不用上送此参数，如需订单结算需传"2"


out_split_info	C	List<>	
拆单信息
合单标识为"1"时必传该字段。,详细字段见out_split_info字段说明	
counter_param	C	String	1024	json字符串 收银台展示参数	{\"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
C	String	128	收银台备注	
busi_type_param	C	String	256	业务类型控制参数，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_info	C	list<>	
签约协议号列表（字符串）	["1234","2345"]，不支持空列表[]；列表中签约协议号不能为空；列表中签约协议号不能重复
product_id
C	String	6	指定产品编号 （200809:线上外卡收银台） 注意：该字段默认不需要指定，特殊场景下使用，慎用	
goods_mark	C	String	
商品信息标识 （1:含商品信息，不填默认不含商品信息）	
goods_field	C	String	2	商品信息域(good_mark送1时该域必填，否则不送。只有线上外卡业务上送该字段) 详细字段见goods_field字段说明	
order_scene_field	C	Object
2	订单场景域，特殊场景下需要上送 详细字段见order_scene_field字段说明	
age_limit	C	String	1	0:不限年龄；1:年龄限制	
repeat_pay_auto_refund	C	String	1	
0:重复支付后不自动退货；1:重复支付后自动退货 （默认不送为0），注意：请详细了解字段场景后上送

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


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

* 网银支付、快捷支付必传此字段 

cash_pay_show_mode	C
String	32	对公支付标识	LQF-对公支付
out_split_info字段说明
字段名	中文名称	是否必填	类型	说明
out_sub_order_no	外部子订单号	M	String(32)	商户子订单号
merchant_no	商户号	M	String(32)	拉卡拉分配的银联商户号
term_no	终端号	M	String(32)	拉卡拉分配的业务终端号
amount	金额	M	String(12)	单位分，整数型字符
settle_type	结算类型（合单）	C	String(4)	"0"或者空，常规结算方式
说明：

 1）拆单信息域中商户号不可重复；

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

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

 4）拆单域中子单条数最少两条、最多50条，否则拒绝。

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

KL_FQ：考拉分期场景

scene_info	订单场景信息	C	String(1024)	订单场景信息（json字符串格式），不同的订单场景类型需要上送的结构不一样（详见具体场景）
HB_FQ场景
scene_info字段说明
字段名	中文名称	是否必填	类型	说明
hbFqNum	花呗分期期数	M	String	支付宝花呗分期必送字段: 花呗分期数 3：3期 6：6期 12：12期
hbFqSellerPercent	卖家承担手续费比例	M	String	支付宝花呗分期必送字段: 卖家承担手续费比例，间连模式下只支持传0。
JDBT场景
scene_info字段说明
字段名	中文名称	是否必填	类型	说明
LOCKPLAN	

String	
->jdbtFqNum	京东白条分期期数	M	String	京东白条分期数 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_no	M	String	32	
银联商户号
channel_id	M	String	32	

out_order_no	M	String	32	商户订单号	
order_create_time	M	String	32	创建订单时间	订单系统创建订单的时间，格式yyyyMMddHHmmss
order_efficient_time	M	String	32	订单有效截至时间	格式yyyyMMddHHmmss
pay_order_no	M	String	64	平台订单号	21070211012001970631000383039
total_amount	M	long	12	订单金额，单位：分	200
counter_url	M	String	256	收银台地址信息	
响应样例
{
    "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一览表
msg	code
成功	000000
