更新时间:2024-03-28 10:27:42
注意:单个商户单日限额2000,划账资金实时到商户账户,次日统一结算。
account/transfer/dotransfer
POST
请求参数
参数名称 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
pay_ver | String | 3 | Y | 版本号,当前版本110 |
merchant_no | String | 15 | Y | 扫呗商户号(用于入账的商户号) |
terminal_id | String | 8 | Y | 终端号 |
terminal_trace | String | 32 | Y | 终端流水号,填写商户系统的订单号 |
terminal_time | String | 14 | Y | 终端交易时间,yyyyMMddHHmmss |
account_out | String | 15 | Y | 出账记账户账号,扣款的账户(传富友侧开通的账户) |
total_fee | Number | 11 | Y | 转账金额 单位:分 |
order_body | String | 128 | N | 订单描述 |
trans_type | String | 1 | N | 转账类型 1:营销,2:核销 不传默认为2 |
attach | String | 128 | N | 附加数据,原样返回 |
key_sign | String | 32 | Y | 签名检验串,非空参数字典排序+令牌(商家令牌名称为access_token),32位md5加密转换 |
返回参数
参数名称 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
return_code | String | 2 | Y | 业务响应码,01成功 02失败 |
return_msg | String | 128 | Y | 业务响应描述 |
key_sign | String | 32 | Y | 签名检验串,拼装所有非空参数+令牌(商家令牌名称为access_token),32位md5加密转换 |
result_code | String | 2 | N | 业务处理响应码,01成功 02失败 |
merchant_name | String | 40 | N | 商户名称 |
merchant_no | String | 15 | N | 扫呗商户号(用于入账的商户号) |
terminal_id | String | 8 | N | 终端号 |
terminal_trace | String | 32 | N | 终端流水号,商户系统的订单号,扫呗系统原样返回 |
terminal_time | String | 14 | N | 终端交易时间,yyyyMMddHHmmss,全局统一时间格式 |
out_transfer_no | String | 32 | N | 利楚唯一转账流水号 |
account_out | String | 15 | Y | 出账记账户账号,扣款的账户 |
total_fee | Number | 11 | Y | 转账金额 单位:分 |
attach | String | 32 | N | 附加数据,原样返回 |
account/transfer/canceltransfer
POST
请求参数
参数名称 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
pay_ver | String | 3 | Y | 版本号,当前版本110 |
merchant_no | String | 15 | Y | 商户号(入账商户号) |
terminal_id | String | 8 | Y | 终端号 |
terminal_trace | String | 32 | Y | 终端流水号,填写商户系统的订单号 |
terminal_time | String | 14 | Y | 终端交易时间,yyyyMMddHHmmss |
pay_trace | String | 32 | N | 传入转账接口中的终端流水号( terminal_trace),与pay_time同时传递 |
pay_time | String | 14 | N | 传入转账接口中的终端交易时间( terminal_time),与pay_trace同时传递 |
out_transfer_no | String | 32 | N | 利楚唯一转账流水号,与 pay_trace 不能同时为空 |
key_sign | String | 32 | Y | 签名检验串,非空参数字典排序+令牌(商家令牌名称为access_token),32位md5加密转换 |
返回参数:
参数名称 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
return_code | String | 2 | Y | 业务响应码,01成功 02失败 |
return_msg | String | 128 | Y | 业务响应描述 |
key_sign | String | 32 | Y | 签名检验串,拼装所有非空参数+令牌(商家令牌名称为access_token),32位md5加密转换 |
result_code | String | 2 | N | 业务处理响应码,01撤销成功 02撤销失败 |
merchant_no | String | 15 | N | 商户号 |
terminal_id | String | 8 | N | 终端号 |
terminal_trace | String | 32 | N | 终端流水号,商户系统的订单号,扫呗系统原样返回 |
terminal_time | String | 14 | N | 终端交易时间,yyyyMMddHHmmss,全局统一时间格式 |
out_transfer_no | String | 32 | N | 利楚唯一转账流水号 |
merchant_in | String | 15 | Y | 扫呗入账商户号,入账的账户 |
account_out | String | 15 | Y | 出账记账户账号,扣款的账户 |
total_fee | Number | 11 | Y | 转账金额 单位:分 |
account/transfer/query
POST
请求参数
参数名称 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
pay_ver | String | 3 | Y | 版本号,当前版本110 |
merchant_no | String | 15 | Y | 商户号 |
terminal_id | String | 8 | Y | 终端号 |
terminal_trace | String | 32 | Y | 终端流水号,填写商户系统的订单号 |
terminal_time | String | 14 | Y | 终端交易时间,yyyyMMddHHmmss |
pay_trace | String | 32 | N | 传入转账接口中的终端流水号( terminal_trace),与pay_time同时传递 |
pay_time | String | 14 | N | 传入转账接口中的终端交易时间( terminal_time),与pay_trace同时传递 |
out_transfer_no | String | 32 | N | 利楚唯一转账流水号,与 pay_trace 不能同时为空 |
key_sign | String | 32 | Y | 签名检验串,非空参数字典排序+令牌(商家令牌名称为access_token),32位md5加密转换 |
返回参数
参数名称 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
return_code | String | 2 | Y | 业务响应码,01成功 02失败 |
return_msg | String | 128 | Y | 业务响应描述 |
key_sign | String | 32 | Y | 签名检验串,拼装所有非空参数+令牌(商家令牌名称为access_token),32位md5加密转换 |
result_code | String | 2 | N | 业务处理响应码,01成功 02失败 |
merchant_no | String | 15 | N | 商户号 |
terminal_id | String | 8 | N | 终端号 |
terminal_trace | String | 32 | N | 终端流水号,商户系统的订单号,扫呗系统原样返回 |
terminal_time | String | 14 | N | 终端交易时间,yyyyMMddHHmmss,全局统一时间格式 |
out_transfer_no | String | 32 | N | 利楚唯一转账流水号 |
merchant_in | String | 15 | Y | 扫呗入账商户号,入账的账户 |
account_out | String | 15 | Y | 出账记账户账号,扣款的账户 |
total_fee | Number | 11 | Y | 转账金额 单位:分 |
transfer_date | String | 8 | Y | 转账时间YYYYMDD |
transfer_status | String | 1 | Y | 转账状态:1-成功 2-失败 4-撤销 7-超时 |
attach | String | 32 | N | 附加数据,原样返回 |
account/transfer/querybalance
POST
请求参数
参数名称 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
pay_ver | String | 3 | Y | 版本号,当前版本110 |
inst_no | String | 15 | Y | 机构编号,扫呗分配 |
trace_no | String | 32 | Y | 请求流水号,不带“-”的uuid |
account_no | String | 15 | Y | 记账户账号 |
key_sign | String | 32 | Y | 签名检验串,非空参数字典排序+令牌(机构令牌名称为key),32位md5加密转换 |
返回参数
参数名称 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
return_code | String | 2 | Y | 业务响应码,01成功 02失败 |
return_msg | String | 128 | Y | 业务响应描述 |
key_sign | String | 32 | Y | 签名检验串,拼装所有非空参数+令牌(机构令牌名称为key),32位md5加密转换 |
result_code | String | 2 | N | 业务处理响应码,01成功 02失败 |
not_settle_amt | String | 11 | N | 清分金额(今日实时交易金额,即新入账金额),单位分 |
settling_amt | String | 11 | N | 清算金额(若商户为手动清算则为可手动提现金额;若商户为自动清算则为等待划款的金额,即清算中金额),单位分 |
settled_amt | String | 11 | N | 结算金额(商户要到账的金额,即可提现金额),单位分 |
book_balance | String | 11 | N | 账面总额(清分金额,清算金额,结算金额三者之和),单位分 |