记帐户转账功能接口

更新时间：2024-11-21 15:10:23

对接必读

  • 1.第1步，请先联系运营同事开通记帐户账号。并通过网银的方式往记帐户的银行卡内，充值充足的金额。
  • 2.第2步，调用1.1记帐户转账接口，account_out为第一步中开通的记帐户账号。
  • 3.第3步，若发生退款，可通过调用1.2记帐户转账撤销接口，进行转账撤销。
  • 4.第4步，若有转账流水和记帐户余额查询的需求，可调用1.3记帐户转账流水查询接口和1.4记帐户余额查询接口

1.1记帐户转账接口

注意**：**单个商户单日限额2000，划账资金实时到商户账户，次日统一结算。

  • url:account/transfer/dotransfer
  • Method: 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 附加数据，原样返回

1.2记帐户转账撤销接口

  • url:<font style="background-color:rgb(249, 242, 244);">account/transfer/canceltransfer</font>
  • Method: <font style="background-color:rgb(249, 242, 244);">POST</font>
  • 备注：只有当天订单可以撤销
请求参数
参数名称 类型 长度 必填 说明
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 转账金额 单位：分

1.3记帐户转账流水查询接口

  • url：account/transfer/query
  • Method: 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 附加数据，原样返回

1.4记帐户余额查询

  • url:<font style="background-color:rgb(249, 242, 244);">account/transfer/querybalance</font>
  • Method: <font style="background-color:rgb(249, 242, 244);">POST</font>
请求参数
参数名称 类型 长度 必填 说明
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 账面总额（清分金额，清算金额，结算金额三者之和），单位分

© 利楚商服 2020 All rights reserved.