记帐户转账功能接口

更新时间:2024-03-28 10:27:42

对接必读

  • 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:account/transfer/canceltransfer
  • 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 转账金额 单位:分

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:account/transfer/querybalance
  • Method: 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 账面总额(清分金额,清算金额,结算金额三者之和),单位分

© 利楚商服 2020 All rights reserved.