分期收银台创单

POST/v1/creditpay/stagecode/apply

分期收银台创单接口：支持返回银联分期码地址和连连分期收银台地址

请求参数

mch_id

string

商户编号

必需

商户编号是商户在连连支付支付平台上开设的商户号码，为18位数字，如：201304121000001004

<= 18 字符

正则匹配:

^\d{16,18}$

user_id

string

用户唯一编号

必需

付款用户唯一编号

<= 40 字符

user_ip

string

用户ip

必需

用户ip

<= 40 字符

txn_seqno

string

商户唯一订单号

必需

商户系统唯一订单号

<= 64 字符

txn_time

string

商户订单时间

必需

格式：YYYYMMDDH24MISS 14位数字，精确到秒

<= 14 字符

order_amount

string

交易金额

必需

该笔订单的资金总额，单位为RMB-元。大于0的数字，精确到小数点后两位。如：49.65

order_info

string

订单描述

可选

订单描述

<= 255 字符

notify_url

string

支付结果通知地址

必需

支付结果通知地址

<= 255 字符

pay_expire

string

订单有效时间

可选

分钟为单位，默认为30分钟（7天），从创建时间开始，过了此订单有效时间此笔订单就会被设置为失败状态不能再重新进行支付。

pay_type

string

pay_type 支付方式

可选

支付方式: STAGE_CODE_PAY (分期码) CREDIT_STAGES_PAY（信用卡分期） JDBT_CREDIT_STAGES_PAY（京东白条分期）

extend_info

string

拓展参数

可选

拓展参数 :
用户实名认证:
user_name: 用户名(string)
sub_mch_id: 渠道子商户号(string)

联合登录:
certification_type: 证件类型(string) 01身份证不上送默认为01
certification_id: 证件编号(string)
customer_name: 姓名(string)
phone_no: 用户手机号(string)
login_status: 用户在商户侧的登录状态(string) 1:已登录 0:未登录，不上送默认为0
scene_identification_code:场景标识（string） 03限定身份信息（非必填）
用户名与联合登陆信息不允许同时有值
联合登录时：customer_name、certification_id、phone_no不能为空

支付结果查询/异步通知接口是否需要渠道信息标识:
need_chnl_data: true/false

例如:
{"user_name":"用户名","sub_mch_id":"渠道子商户号","certification_type":"证件类型","certification_id":"证件编号","customer_name":"姓名","phone_no":"用户手机号","login_status":"登录状态"}

共享商户号：
share_mch_id: 共享商户号
业务场景:
busi_scene:PHONE_STAGE（手机分期）、SPEND_STAGE（话费分期）
BARE_METAL_STAGE（裸机分期）
渠道商户号路由因子（营销地区活动必填）：
province_code:地区省份编码
city_code:地区城市编码
busi_mode: 商务模式 ONLINE/OFFLINE
京东白条必须：
jdbt_data:{
contract_type：签约类型,固定值为1,
contract_order_id: 签约订单号,
trade_scene：交易场景
枚举：{
ONLINE：线上，OFFLINE：线下
}
if_pickup：配送方式
枚举：{
DELIVERY：配送，SELF_PICKUP：自提
}
province_name: 省份名称-线上配送必填
city_name: 城市名称-线上配送必填
order_source: 消费者下单来源-线下or自提必填；
枚举：{
WECHAT_APP_SCAN:微信APP扫一扫
JD_PAY:京东金融
JD:京东
}
pay_user_id:线下or自提，如有则传；三方支付侧用户ID。
pay_code_id: 线下or自提必填；商户收款码ID，可以是商家展业所应用的静态码/动态码所发生的终端设备唯一识别序列号。
shop_province_name: 线下or自提必填；商户所在省，上海/广东/ 新疆（注：不要带市或省或自治区）
shop_city_name: 线下or自提必填；商户所在市，上海市/广州市/ 乌鲁木齐市
shop_county_name: 线下or自提必填；商户所在区，浦东新区/天河区/ 新市区
shop_address: 线下or自提必填；商户详细地址，xxxxxx街xxx号
his_overdue_times: 用户历史欠费次数，如有则传
ct_days: 用户在网时长，如有则传
}
// 若是参与活动的金额不是订单金额可以自定义上送参与活动金额但必须小于订单金额
customize_promotion_amount: 自定义参与活动金额

<= 1024 字符

return_url

string

返回地址

可选

返回地址。若想更改为get请求，可在返回地址增加jump=page字段，例如：https://open.lianlianpay.com?jump=page

<= 256 字符

goods_info

object (商品信息)

商品信息

可选

参考示例：商品信息详情参数

goods_id

string

商品编码

必需

<= 32 字符

示例值:

100001

goods_name

string | null

商品名称

必需

<= 64 字符

示例值:

test-100001

goods_category

string | null

商品类目

可选

<= 24 字符

goods_quantity

string

商品数量

可选

goods_price

string | null

商品单价

可选

<= 8 字符

goods_body

string | null

商品描述

可选

<= 64 字符

store_info

object (门店信息详情)

门店信息

可选

参考示例：门店信息详情参数

store_id

string

门店号

必需

<= 32 字符

示例值:

门店号

store_name

string | null

门店名称

可选

<= 64 字符

示例值:

门店名称

area_code

string | null

行政区编码

可选

详见4.3行政区编码枚举

>= 6 字符<= 6 字符

示例值:

110000

store_addr

string | null

门店地址

可选

<= 128 字符

示例值:

门店地址

cashier_no

string | null

收银员编号

可选

<= 64 字符

示例值:

收银员编号

stage_info

object (StageInfoVo)

分期信息

必需

参考示例: 分期参数详情参数

stage_num

string

期数

可选

多个期数用&连接如3&6, 分期支付申请只能有一个期数

<= 16 字符

support_bank_code

string

银行编码

可选

多个银行编码用&连接如 00003434&00002312，分期支付申请不需要银行编码

<= 512 字符

device_info

object (设备信息)

设备信息

可选

参考示例：设备信息详情参数

device_id

string

设备标识码

必需

<= 64 字符

示例值:

123456

device_type

string | null

设备类型

可选

SMQ-扫码枪
BOX-收款盒子
POS-POS机
PC-个人电脑
PAD-平板电脑
PHONE-手机

<= 16 字符

示例值:

SMQ

device_ip

string | null

设备IP

可选

<= 32 字符

示例值:

10.2.1.3

device_gps

string | null

设备GPS

可选

<= 64 字符

示例值:

45.03

device_imei

string | null

设备IMEI

可选

<= 64 字符

示例值:

示例IMEI

device_imsi

string | null

设备IMSI

可选

<= 64 字符

示例值:

示例IMSI

device_iccid

string | null

设备ICCID

可选

<= 64 字符

示例值:

示例ICCID

device_wifimac

string | null

设备WIFIMAC

可选

<= 64 字符

示例值:

示例WIFIMAC

device_mac

string | null

设备MAC

可选

<= 64 字符

示例值:

示例MAC

share_info

object

分账方信息

可选

参考示例：分账方信息详情参数

share_list

array[object (分账方信息(分期)) {4}] | null

分账列表信息

可选

req_reserved

string

商户自定义透传域

可选

商户自定义透传域，字符串格式，不限制内容

<= 2048 字符

card_info

object (BindCardInfoVo)

绑卡信息

可选

参考示例：绑卡信息详情参数

card_no

string

银行卡号

可选

银行卡号（连连公钥加密）

<= 32 字符

id_type

string

用户证件类型

可选

用户证件类型

id_no

string

用户证件号

可选

用户证件号（连连公钥加密）

<= 32 字符

acct_name

string

用户名称

可选

用户名称（连连公钥加密）

<= 32 字符

bind_phone

string

预留手机号

可选

预留手机号（连连公钥加密）

<= 11 字符

正则匹配:

^1[3456789]\d{9}$

agree_no

string

协议号

可选

协议号和四要素二选一,都传优先使用协议号

<= 32 字符

platform

string

协议共享商户号

可选

共享协议所属协议号

risk_item

string

风控信息

可选

连连风控部门要求商户统一传入风险控制参数字段，字段值为json 字符串的形式。传入示例及要求见风险控制说明。以下参数必填
request_imei：设备ID
user_info_dt_register：用户注册时间，格式YYYYMMDDH24MISS
user_login_method：用户登录方式
登录密码：PASSWORD
动码：DYNAMIC_CODE
人脸：FACE
FACEID：FACEID
指纹：FINGERPRINT

discount_mode

string

贴息模式

可选

枚举值:商户贴息(merchant)、用户贴息(user)，默认商户贴息

默认值:

DiscountModeEnum.MERCHANT.getCode()

{
  "mch_id": "302112250000006404",
  "timeStamp": "20250520102747",
  "user_id": "USR20240523135749000601",
  "txn_seqno": "PUR20250520102747001852",
  "txn_time": "20250520145547",
  "order_amount": "2989.99",
  "order_info": "YX20250520102743000653",
  "notify_url": "https://cp-uat.cmft.com.cn:8443/ecology-ogw-gatway/ecology-card-installment-business/v1/credit-card/lian-lian-pay/order-result-notify",
  "pay_expire": "711",
  "pay_type": "JDBT_CREDIT_STAGES_PAY",
  "user_ip": "127.0.0.1",
  "discount_mode": "merchant",
  "return_url": "http://cp-uat.cmft.com.cn:32099/front-msa/ECIPay/?addr_back=1&orderNo=INS20250520094929002651&orderDate=20250520",
  "stage_info": {
    "stage_num": "24",
    "support_bank_code": "99990007"
  },
  "goods_info": {
    "goods_id": "186****1167",
    "goods_name": "测试商品"
  },
  "store_info": {
    "store_id": "20211227101240",
    "store_name": "测试门店"
  },
  "share_info": {
    "share_list": [
      {
        "share_uid": "20211227101240",
        "share_memo": "入账商户",
        "share_amount": "2930.19"
      }
    ]
  },
  "extend_info": "{\"busi_mode\":\"OFFLINE\",\"busi_scene\":\"PHONE_STAGE\",\"certification_id\":\"430321198705050716\",\"certification_type\":\"01\",\"city_code\":\"430100\",\"customer_name\":\"谭杰\",\"jdbt_data\":\"{\\\"if_pickup\\\":\\\"SELF_PICKUP\\\",\\\"order_source\\\":\\\"ZYJK_APP\\\",\\\"pay_code_id\\\":\\\"TEST_DEP\\\",\\\"pay_user_id\\\":\\\"18684741167\\\",\\\"shop_address\\\":\\\"黄土岭999号\\\",\\\"shop_city_name\\\":\\\"长沙\\\",\\\"shop_county_name\\\":\\\"岳麓区\\\",\\\"shop_province_name\\\":\\\"湖南\\\",\\\"trade_scene\\\":\\\"OFFLINE\\\"}\",\"login_status\":\"1\",\"need_chnl_data\":\"true\",\"phone_no\":\"18684741167\",\"province_code\":\"430000\"}",
  "req_reserved": "{\"client_type\":\"01\"}",
  "card_info": {
    "acct_name": "W70qjs3vqQPbxjryS8wXG725FM/jKK+EUHEeIQoD43M9iXshhO49VWvgmuOK8LVMZTylgEfK4bH5S1atzosy892Q4Md48ls/M/TCOUBi7SBDSIc+udfFqxP5Gr3UKTOTNI4gVjbCfcDdAEUGPYEo3VTkAYsyOpCBBuP/vh+6knc=",
    "bind_phone": "Yok5gkixea8AUzn0CVnhgbpANj5BUH9RGNOHfcgWlOHu5CjMv/uKrrmmEHG/vtgdjxSNqNGgxg+rudpM+1mAsgLipNR4GjRCnlMxczCeh913coC1UknPiiCFIp/08O4vNW5g1fCWa1YPaz/LxkiYRLh5HRI46cUjjElw6e6WONM=",
    "id_no": "MlKUOcyNYpqF0wCPro/nOv/9yxWJQjGVct2N0QkrBRKRFa6ljUKyppymiMHyxZUhJCvC/mU/D8Hb4jFhhhe/xk1KHam9sd7OqQeTWocM/NA8lbdR6iTw7LkalWH1WSCPHcx5Ux0QAv+tw8/0H2zd7joRiVd3K4LQbu6Xhb8N/jk="
  }
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

com.lianlianpay.mpay.openapi.facade.vo.res.creditpay.StageCodePayApplyResVo

ret_code

string

交易结果代码

必需

0000 见返回码

ret_msg

string

交易结果描述

必需

交易成功

mch_id

string

商户编号

必需

商户编号是商户在连连支付支付平台上开设的商户号码，为18位数字，如：201304121000001004

txn_time

string

商户订单时间

必需

格式：YYYYMMDDH24MISS 14位数字，精确到秒

txn_seqno

string

商户唯一订单号

必需

商户系统唯一订单号

platform_txno

string

平台支付交易单号

必需

平台支付支付订单唯一编号：如2011030900001098

order_amount

number

交易金额

必需

该笔订单的资金总额，单位为RMB-元。大于0的数字，精确到小数点后两位。如：49.65

payload

string

支付参数集合

可选

返回外部渠道的标准支付提交参数
分期码示例
"payload":"{"gateway_url":"https://fts.unionpay.com/aps/aps1/dynamic/loading.html#loading?id=af46fa914e4fbabfa4c43\"}"
信用卡分期示例"payload":"{"gateway_url":"https://payment.lianlianpay.com/mpayweb/payinit?token=1234ABCD\"}"

{
  "ret_code": "",
  "ret_msg": "",
  "mch_id": "",
  "txn_time": "",
  "txn_seqno": "",
  "platform_txno": "",
  "order_amount": "",
  "payload": ""
}