调用地址
使用HTTP协议，POST方式提交。
测试环境：https://test.wsmsd.cn/sit/api/v3/labs/trans/share_code
生产环境：https://s2.lakala.com/api/v3/labs/trans/share_code
请求报文
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|
| merchant_no | 商户号 | M | String(32) | 拉卡拉分配的商户号 |
| term_no | 终端号 | M | String(32) | 拉卡拉分配的业务终端号 |
| out_trade_no | 商户交易流水号 | M | String(32) | 商户系统唯一 |
| account_type | 钱包类型 | M | String(32) | 支付宝：ALIPAY |
| total_amount | 金额 | M | String(12) | 单位分，整数型字符 |
| location_info | 地址位置信息 | M | Object | 地址位置信息，风控要求必送 |
| code_valid_period | 码有效期 | C | String(8) | 秒为单位,整型 |
| acc_busi_fields | 账户端业务信息域 | C | Object | 参见以下acc_busi_fields字段详细说明,不同的account_type，需要传入的参数不一样 |
location_info字段说明
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|
| request_ip | 请求方IP地址 | M | String(64) | 请求方的IP地址，存在必填，格式如36.45.36.95 |
| base_station | 基站信息 | C | String(128) | 客户端设备的基站信息（主扫时基站信息使用该字段） |
| location | 纬度,经度 | C | String(32) | 商户终端的地理位置，存在必填 格式：纬度,经度，+表示北纬、东经，-表示南纬、 西经，精度最长支持小数点后9位。举例:+37.123456789,-121.123456789 |
支付宝场景下acc_busi_fields域内容
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|
| source | 业务来源 | M | String(128) | 业务来源，业务接入的约定标识，代表业务的调用方，内容与支付宝约定，若无约定可上送拉卡拉侧约定值。例如：ISV公司名称缩写 |
| biz_link | 跳转业务链接 | M | String(1024) | 支付页面url |
| seller_id | 卖家支付宝ID | C | String(32) |
|
| ext_info | 扩展内容 | C | Object | 扩展内容，主要满足花呗分期相关的额鉴权验等功能 |
支付宝ext_info字段说明
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|
| fq_number | 花呗分期期数 | C | String(5) | 支付宝花呗分期必送字段: 花呗分期数 3：3期 6：6期 12：12期 |
| fq_seller_percent | 卖家承担手续费比例 | C | String(3) | 支付宝花呗分期必送字段: 卖家承担收费比例，商家承担手续费传入100，用户承担手续费传入0，仅支持传入100、0两种，其他比例暂不支持 100：代表商家贴息 0：代表用户承担手续费 |
响应报文
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|
| merchant_no | 商户号 | M | String(32) | 拉卡拉分配的商户号（请求接口中商户号） |
| out_trade_no | 商户请求流水号 | M | String(32) | 请求报文中的商户请求流水号 |
| trade_no | 拉卡拉交易流水号 | M | String(32) | 拉卡拉交易流水号 |
| acc_resp_fields | 账户端返回信息域 | C | Object | 账户端返回信息域 |
支付宝场景下返回acc_resp_fields域
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|
| share_token | 吱口令 | M | String | 支付返回的吱口令token |
| expire_date | 吱口令失效时间 | C | String | 吱口令失效时间，若为空则表示永久有效 |
示例
请求报文
{
"out_org_code": "OP00000003",
"req_data": {
"merchant_no": "8222900701105HK",
"term_no": "A1013503",
"out_trade_no": "20230908test000000001",
"total_amount": "1",
"account_type": "ALIPAY",
"code_valid_period": "60",
"acc_busi_fields": {
"biz_link": "https://www.test.com",
"ext_info": {
"fq_number": "3",
"fq_seller_percent": "0"
}
},
"location_info": {
"request_ip": "12.34.56.78",
"base_station": "00 6361 58130",
"location": "+37.123456789,-121.123456789"
}
},
"req_time": "20220225222402",
"version": "3.0"
}复制
响应报文
{
"msg": "成功",
"resp_time": "20211018165606",
"code": "BBS00000",
"resp_data": {
"acc_resp_fields": {
"expire_date": "20231010162729",
"share_token": "wETN2b480lM $547 E@p.IrGO u:/a"
},
"merchant_no": "8222900701105HK",
"out_trade_no": "20230908test000000001",
"trade_no": "2023101066210310250453"
}
}
}复制
