网关支付-统一创单

POST/v1/ipay/createpay

统一创单

请求参数

Header 参数

mch_id

string

可选

示例值:

2020042200284052

mch_id

string

商户编号

必需

商户在平台上开设的商户号码，为18位数字

<= 18 字符

示例值:

2020042200284052

sub_mchid

string | null

子商户编号

可选

子商户编号

<= 18 字符

示例值:

302210180000021525

user_id

string

用户编号

必需

商户系统中用户唯一标识

<= 64 字符

示例值:

pWDslsPANCa4rimg0byYcXR4F8avAF08

busi_type

string

业务类型

必需

业务类型
"100001": "虚拟商品购买"
"100002": "实物商品租购"
"100099": "其他商家消费"
"120001": "商业众筹"
"120002": "信贷偿还"
"130001": "支付账户充值"

示例值:

100001

txn_seqno

string

商户支付订单号

必需

商户系统唯一订单号

<= 32 字符

示例值:

SOgKCGouScflQDsTw6I8Nm11DzTZEn5n

txn_time

string <YYYYMMDDH24MISS>

商户支付订单时间

必需

商户支付订单时间格式：YYYYMMDDH24MISS 14位数字精确到秒

<= 14 字符

示例值:

20231207161814

order_amount

string

订单金额

必需

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

<= 11 字符

示例值:

49.65

order_info

string | null

订单描述

可选

订单描述

<= 255 字符

pay_expire

integer | null

订单有效时间

可选

订单有效时间，分钟为单位。默认3天有效期。

notify_url

string

支付结果通知地址

必需

支付结果通知地址

<= 255 字符

示例值:

https://test.lianlianpay-inc.com/llpaytest/mpspNotifyReceive_test.htm

risk_item

string

风控参数

必需

风控参数需按照json格式，统一传入到订单的支付请求中的参数risk_item中，例如:
{
"risk_item":"{"frms_ware_category":"1002","user_info_mercht_userno":"...","user_info_mercht_userlogin":"","user_info_mail":"","user_info_bind_phone":"...","user_info_mercht_usertype":"","user_info_dt_registe":"20180206143300","user_info_register_ip":"","user_info_full_name":"...","user_info_id_type":"0","user_info_id_no":"...","user_info_identify_state":"0","user_info_identify_type":"4"}"
}

share_flag

string

分账标识

可选

IMMEDIATE-即时分账
DELAY-延迟分账
注：默认不分账；当上送标识为延迟分账，分账列表可为空；

divide_notify_url

string

分账结果通知地址

可选

分账结果通知地址

<= 255 字符

sessionKey

string

可选

通常通过微信支付的API接口获取（微信B2B直连支付必传）

extend_info

string | null

扩展信息

可选

扩展信息。微信公众号，微信小程序，微企付小程序、微信APP，支付宝应用，数字人民币支付时需传额外扩展参数。
如需对接数币子钱包功能，需另申请数币接口文档。
扩展信息中微信、支付宝、数字人民币信息选其一填写，对象格式参考示例如下(apiFox中，空格会被忽略，所以用_表示空格缩进)：
forbidden_card_type：非必传，传no_credit则禁用贷记卡，不传则不禁用，card_type 非必传传了代表指定卡类型支付（目前仅适用于云闪付小程序支付）
{
"wx_data":{
"wx_sub_mchid": "微信子商户号",
"appid": "微信appid",
"openid": "微信用户标识",
"forbidden_card_type": "no_credit",
"req_domain":"请求域名,支付方式h5时必传，商户h5来源域名",
"back_url":"当支付过程中，在收银台页面左下角激活"返回"按钮，用户点击返回后跳转向该地址(POST)。如不传则返回按钮不显示。",
"appKey":"通过小程序MP查看","sessionKey":"小程序 appId和appSecret获取",
"wechat_mode":微信B2B模式，直连(DIRECT)或间连(INDIRECT)
},
"alipay_data":{
"ali_sub_mchid": "支付宝子商户号",
"appid": "支付宝appid",
"openid": "支付宝用户标识",
"forbidden_card_type": "no_credit",
"goods_detail": [{"goods_id":"商品编号","goods_name":"商户名称","quantity":"商品数量","price":"商品价格"]
},
"dc_data":{
"client_ip": "终端用户ip",
"qr_code": "数字人民币-主扫必填 ",
"trade_adrss": "交易地点(不超过24个字符)",
"biz_type": "业务类型（见业务类型编码和业务种类编码说明）",
"category_code": "种类编码",
"client_no": "受理终端编号(不超过24个字符)",
"creditor_wallet_id": "收款方钱包id",
//需要数币子钱包推送的场景
"scene_id":"数币子钱包推送必填-场景id",
"phone":"数币子钱包推送必填-用户手机号",
"account_id":"数币子钱包推送必填-用户账号",
"verify_code":"数币子钱包推送必填-用户授权码"
},
"unionpay_data":{
"forbidden_card_type":"no_credit",
"appid"："小程序或者公众号的appid（云闪付小程序、微企付H5必传）",
"scene":"场景（云闪付小程序必传）",
"goods_tag": "优惠标记"
},
"card_type"："卡类型",
"return_url":"支付成功跳转地址（云闪付WAP 必传）"
微信支付宝实名信息"identity":"{"type":"IDCARD","number":"333000000000000000","name":"张三"}"
}
扩展字段中的枚举示例
scene 枚举
PUBLIC_ACCOUNT("PUBLIC_ACCOUNT","公众号")
APPLET("APPLET","小程序")

card_type 枚举
DEBIT_CARD("DEBIT_CARD","借记卡")
CREDIT_CARD("CREDIT_CARD","信用卡")

pay_method_infos

array [object {2}]

支付方式列表

必需

对象格式，参考示例：支付方式信息详情参数
PS:必传，多支付方式时，只支持一个收款方

pay_type

string

支付方式

必需

"WECHAT_JSAPI": "微信公众号"
"WECHAT_NATIVE": "微信扫码"
"WECHAT_APPLET": "微信小程序"
"WECHAT_APP": "微信APP"
"WECHAT_H5": "微信H5"
"ALIPAY_NATIVE": "支付宝扫码"
"ALIPAY_APPLET": "支付宝应用（小程序、生活号）"
"DC_NATIVE": "数字人民币扫码"
"DC_APP": "数字人民币APP"
"POS_NATIVE": "POS收款"
"AGGREGATE_CODE": "聚合码扫码"
"STATIC_CODE": "静态码"
"B2C_EBANK": "个人网银"
"B2B_EBANK": "企业网银"
"B2B_ORDER_EBANK": "企业网银订单支付"
"CLOUDPAY_APP": "云闪付APP"
"CLOUDPAY_WAP": "云闪付WAP"
"CLOUDPAY_APPLET": "云闪付小程序"
"QUICK_PAY": "快捷支付"
"COUPON_PAY": "优惠卷"
"UNIONPAY_JSAPI": "云闪付JS支付"
"PUBLIC_QUICK_PAY": "对公快捷"
"PUBLIC_ENTRUST_PAY": "对公代收"
"WECHAT_BUSI_APP":"微企付APP"
"WECHAT_BUSI_APPLET":"微企付小程序"
"WECHAT_BUSI_H5":"微企付H5"
"WECHAT_BUSI_NATIVE":"微企付扫码"
"WECHAT_BUSI_PC":"微企付PC"
"WECHAT_B2B_APPLET":"微信B2B"

示例值:

WECHAT_JSAPI

amount

string

金额

必需

该支付方式对应的金额，单位为元

goods_info

array [object {6}]

商品信息

必需

商品信息

goods_id

string

商品编码

必需

<= 32 字符

示例值:

100001

goods_name

string | null

商品名称

必需

<= 40 字符

示例值:

test-100001

goods_category

string | null

商品类目

可选

<= 24 字符

goods_quantity

string

商品数量

可选

goods_price

string | null

商品单价

可选

<= 8 字符

goods_body

string | null

商品描述

可选

<= 64 字符

risk_info

object (风控信息)

风控信息（即将废弃）

可选

（即将废弃）兼容旧商户，新商户请参考risk_item

ip_addr

string | null

交易地址

可选

<= 64 字符

longitude

string | null

经度信息

可选

<= 32 字符

latitude

string | null

纬度信息

可选

<= 32 字符

cell_id

string | null

基站地址

可选

<= 32 字符

示例值:

33.11,123.33

user_register_time

string <YYYYMMDDH24MISS> | null

商户端用户注册时间

可选

<= 14 字符

示例值:

20230703212500

user_login_method

string | null

用户本次登录验证方式

可选

登录密码：PASSWORD
动码：DYNAMIC_CODE
人脸：FACE
FACEID：FACEID
指纹：FINGERPRINT

<= 32 字符

示例值:

PASSWORD

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

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 字符

示例值:

收银员编号

divide_infos

array[object (分账方信息) {3}]

分账方信息

可选

即时分账-订单分账模式，该信息必传；其他情况不允许传该信息；

divide_uid

string

分账方商户号

必需

<= 18 字符

divide_amount

number

分账金额

必需

分账金额以元为单位，2位小数

divide_memo

string

分账说明

可选

分账备注,该字段会透传到渠道

<= 64 字符

{
  "mch_id": "2020042200284052",
  "sub_mchid": "302210180000021525",
  "user_id": "pWDslsPANCa4rimg0byYcXR4F8avAF08",
  "busi_type": "100001",
  "txn_seqno": "SOgKCGouScflQDsTw6I8Nm11DzTZEn5n",
  "txn_time": "20231207161814",
  "order_amount": "49.65",
  "order_info": null,
  "pay_expire": 54,
  "notify_url": "https://test.lianlianpay-inc.com/llpaytest/mpspNotifyReceive_test.htm",
  "risk_item": "laborum",
  "share_flag": "IMMEDIATE",
  "divide_notify_url": "https://measly-cross-contamination.com/",
  "sessionKey": "enim Lorem Duis id eiusmod",
  "extend_info": null,
  "pay_method_infos": [
    {
      "pay_type": "WECHAT_JSAPI",
      "amount": "49.65"
    }
  ],
  "goods_info": [
    {
      "goods_id": "100001",
      "goods_name": "test-100001",
      "goods_category": null,
      "goods_quantity": "77",
      "goods_price": "148.85",
      "goods_body": "nisi irure pariatur es"
    }
  ],
  "risk_info": {
    "ip_addr": null,
    "longitude": "18.587",
    "latitude": "-11.507",
    "cell_id": "33.11,123.33",
    "user_register_time": "20230703212500",
    "user_login_method": "PASSWORD"
  },
  "device_info": {
    "device_id": "123456",
    "device_type": "SMQ",
    "device_ip": "10.2.1.3",
    "device_gps": "45.03",
    "device_imei": "示例IMEI",
    "device_imsi": "示例IMSI",
    "device_iccid": "示例ICCID",
    "device_wifimac": "示例WIFIMAC",
    "device_mac": "示例MAC"
  },
  "store_info": {
    "store_id": "门店号",
    "store_name": "门店名称",
    "area_code": "110000",
    "store_addr": "门店地址",
    "cashier_no": "收银员编号"
  },
  "divide_infos": [
    {
      "divide_uid": "85",
      "divide_amount": 836.35,
      "divide_memo": "3"
    },
    {
      "divide_uid": "25",
      "divide_amount": 490.89,
      "divide_memo": "66"
    },
    {
      "divide_uid": "94",
      "divide_amount": 36.89,
      "divide_memo": "78"
    }
  ]
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

ret_code

string

交易结果代码

必需

交易结果代码
0000 见返回码
8888 短信已下发，需要继续进行二次短信验证才能继续交易
可参考返回码列表
https://api-doc.lianlianpay.com/openplatform/doc-338978

示例值:

0000

ret_msg

string

交易结果描述

必需

交易结果描述

<= 100 字符

mch_id

string

商户编号

可选

受理成功时返回,商户编号，商户编号是商户在平台上开设的商户号码，为18位数字

<= 18 字符

示例值:

201304121000001004

txn_seqno

string

商户支付订单号

可选

受理成功时返回,商户系统唯一订单号

<= 32 字符

platform_txno

string

平台支付订单号

可选

受理成功时返回,连连订单唯一编号

<= 18 字符

示例值:

2011030900001098

order_amount

string

订单金额

可选

受理成功时返回,该笔订单的资金总额，单位为RMB-元。大于0的数字，精确到小数点后两位。

<= 8 字符

示例值:

49.65

payload

string | null

支付信息

可选

js支付信息、二维码信息

token

string | null

二次验证token

可选

当存在余额支付时，如果开启余额短信验证时，改字段必返回。当改字段返回时，需要调用5.10.3 二次短信验证接口继续交易。

extend_info

object (扩展参数 kv)

扩展参数

可选

扩展参数 kv

key

string | null

可选

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