入金记录查询

更新时间： 2026年9月29日 05:43

接口说明

入金记录查询属于虚拟银行接口。调用方需按公共参数组装请求并完成签名；响应包含 sign 时，应先验签再解析 bizData。

接口名称	入金记录查询
请求方式	POST
正式地址	https://pay.rscygroup.com/api/open/virtualBank/query/deposit
沙箱地址	https://pay-test.rscygroup.com/api/open/virtualBank/query/deposit
签名方式	MD5 ，按签名规则说明生成或校验 sign
结果判定	先判断公共返回 code，成功后验签并解析 bizData；本接口仅返回入金成功记录，不提供状态字段，也不支持状态检索

流程图

处理要点：

请求前先将业务字段组装为 bizData JSON 字符串，再和公共参数一起参与签名。
响应包含 sign 时，应先按签名规则验签，再解析 bizData。
code=000000 表示接口请求处理成功；本接口返回列表均为成功入金记录。
日期范围必填，且 startDate 到 endDate 的跨度不能超过 1 个月。
amount、fee、realAmount 均以“分”为单位。

请求参数

字段名	变量名	必填	类型	示例值	描述
应用ID	apiKey	是	String	<SIGNATURE>	账号中心 > 开放接口密钥
签名	sign	是	String	-	签名
签名方式	signType	是	String	MD5	签名方式账号中心 > 开放接口密钥
业务参数	bizData	-	String	-	业务参数JSON形式的字符串
请求时间	reqTime	是	String(14)	<DEMO_ID>	格式为 yyyyMMddHHmmss
接口版本号	version	是	String	1.0	当前固定位1.0
请求的唯一ID	reqId	是	String(40)	-	自定义生成随机唯一字符串

字段名	变量名	必填	类型	示例值	描述
查询开始日期	startDate	是	String	2026-06-18	格式 yyyy-MM-dd
查询结束日期	endDate	是	String	2026-06-22	不能早于 startDate，且日期跨度不能超过 1 个月
入金账户号	payeeAcctNo	是	String	123	按表字段 payee_acct_no 精确查询
页码	page	否	Long	1	默认 1
每页条数	pageSize	否	Long	10	默认 10，取值范围 1-100

响应参数

字段名	变量名	必填	类型	示例值	描述
返回码	code	是	String	000000	公共返回码
返回信息	msg	否	String	成功	返回信息或错误原因
响应时间	timestamp	否	String	<DEMO_ID>	格式 yyyyMMddHHmmss
响应签名类型	signType	否	String	MD5	响应签名类型
响应签名	sign	否	String	响应签名	响应包含签名时需先验签
业务返回参数	bizData	否	String	-	业务返回参数 JSON 字符串

字段名	变量名	必填	类型	示例值	描述
总记录数	total	否	Long	2	符合条件的总记录数
当前页码	page	否	Long	1	当前页码
每页条数	pageSize	否	Long	10	每页条数
入金记录列表	depositList	否	Array	-	入金记录列表

字段名	变量名	必填	类型	示例值	描述
订单号	orderNo	否	String	IN<DEMO_ID>	入金订单号
入金金额	amount	否	Long	1000	单位：分
手续费	fee	否	Long	0	单位：分
实际入账金额	realAmount	否	Long	1000	单位：分
手续费承担方式	feeType	否	String	-	手续费承担方式
付款账户号	payerAcctNo	否	String	-	付款账户号
付款户名	payerName	否	String	-	付款户名
付款银行号	payerBankNo	否	String	-	付款银行号
入金账户号	payeeAcctNo	否	String	VC960116	入金账户号
入金账户名称	payeeName	否	String	-	入金账户名称
入金账户银行号	payeeBankNo	否	String	-	入金账户银行号
备注	remark	否	String	-	备注
错误码	errCode	否	String	-	入金成功记录通常为空
-	-	-	-	-	入金成功记录通常为空
入金时间	depositTime	否	String	2026-06-22 14:53:26	格式 yyyy-MM-dd HH:mm:ss

请求示例

以下示例默认使用 MD5 作为演示模式。签名时先将公共参数按字段名升序排序并拼接为 key=value&key=value，再在原串末尾追加 &appSecret=... 后计算 MD5；生成 sign 后，实际请求体中不要传 appSecret。本页请求示例依赖统一签名实现。

bash

curl -X POST "https://pay.rscygroup.com/api/open/virtualBank/query/deposit" \
  -H "Content-Type: application/json" \
  -d '{
    "reqId": "test<DEMO_ID>",
    "version": "1.0",
    "reqTime": "<DEMO_ID>",
    "apiKey": "<CONFIGURED_VALUE>",
    "signType": "MD5",
    "bizData": "{\"startDate\":\"2026-06-18\",\"payeeAcctNo\":\"123\",\"endDate\":\"2026-06-22\",\"page\":1,\"pageSize\":10}",
    "sign": "<按签名规则生成>"
  }'

bash

curl -X POST "https://pay-test.rscygroup.com/api/open/virtualBank/query/deposit" \
  -H "Content-Type: application/json" \
  -d '{
    "reqId": "test<DEMO_ID>",
    "version": "1.0",
    "reqTime": "<DEMO_ID>",
    "apiKey": "<CONFIGURED_VALUE>",
    "signType": "MD5",
    "bizData": "{\"startDate\":\"2026-06-18\",\"payeeAcctNo\":\"123\",\"endDate\":\"2026-06-22\",\"page\":1,\"pageSize\":10}",
    "sign": "<按签名规则生成>"
  }'

复用统一签名实现中的 genSign / verifySign 通用方法。

java

Map<String, Object> biz = new LinkedHashMap<>();
biz.put("startDate", "2026-06-18");
biz.put("endDate", "2026-06-22");
biz.put("payeeAcctNo", "123");
biz.put("page", 1);
biz.put("pageSize", 10);

Map<String, String> req = new LinkedHashMap<>();
req.put("reqId", "DEPOSIT" + System.currentTimeMillis());
req.put("version", "1.0");
req.put("reqTime", "<DEMO_ID>");
req.put("apiKey", "<DEMO_ID>");
req.put("signType", "MD5");
req.put("bizData", mapper.writeValueAsString(biz));
req.put("sign", SignDemo.genSign(req, "MD5"));

PHP 示例中的 SignDemo 类不在本页定义，推荐来自统一签名类实例。

php

<?php
require_once __DIR__ . '/SignDemo.php';
$demo = new SignDemo();

$biz = [
    'startDate' => '2026-06-18',
    'endDate' => '2026-06-22',
    'payeeAcctNo' => '123',
    'page' => 1,
    'pageSize' => 10,
];

$req = [
    'reqId' => 'DEPOSIT' . time(),
    'version' => '1.0',
    'reqTime' => '<DEMO_ID>',
    'apiKey' => '<DEMO_ID>',
    'signType' => 'MD5',
    'bizData' => json_encode($biz, JSON_UNESCAPED_UNICODE),
];
$req['sign'] = $demo->genSign($req);

python

biz = {
    "startDate": "2026-06-18",
    "endDate": "2026-06-22",
    "payeeAcctNo": "123",
    "page": 1,
    "pageSize": 10,
}
req = {
    "reqId": f"DEPOSIT{int(time.time())}",
    "version": "1.0",
    "reqTime": "<DEMO_ID>",
    "apiKey": "<CONFIGURED_VALUE>",
    "signType": "MD5",
    "bizData": json.dumps(biz, ensure_ascii=False),
}
req["sign"] = gen_sign(req, "MD5")

javascript

const biz = {
  startDate: '2026-06-18',
  endDate: '2026-06-22',
  payeeAcctNo: '123',
  page: 1,
  pageSize: 10,
};
const req = {
  reqId: 'DEPOSIT' + Date.now(),
  version: '1.0',
  reqTime: '<DEMO_ID>',
  apiKey: '<CONFIGURED_VALUE>',
  signType: 'MD5',
  bizData: JSON.stringify(biz),
};
req.sign = genSign(req, 'MD5');

json

{
  "reqId": "test<DEMO_ID>",
  "version": "1.0",
  "reqTime": "<DEMO_ID>",
  "apiKey": "<DEMO_ID>",
  "signType": "MD5",
  "bizData": "{\"startDate\":\"2026-06-18\",\"payeeAcctNo\":\"123\",\"endDate\":\"2026-06-22\",\"page\":1,\"pageSize\":10}",
  "sign": "<SIGNATURE>"
}

响应示例

json

{
  "code": "000000",
  "msg": "成功",
  "timestamp": "<DEMO_ID>",
  "signType": "MD5",
  "sign": "响应签名",
  "bizData": "{\"total\":2,\"page\":1,\"pageSize\":10,\"depositList\":[{\"orderNo\":\"IN<DEMO_ID>\",\"amount\":1000,\"fee\":0,\"realAmount\":1000,\"payeeAcctNo\":\"VC960116\",\"depositTime\":\"2026-06-22 14:53:26\"},{\"orderNo\":\"IN<DEMO_ID>\",\"amount\":1000,\"fee\":6,\"realAmount\":994,\"payeeAcctNo\":\"VA<DEMO_ID>\",\"depositTime\":\"2026-06-18 17:09:22\"}]}"
}

json

{
  "total": 2,
  "page": 1,
  "pageSize": 10,
  "depositList": [
    {
      "orderNo": "IN<DEMO_ID>",
      "amount": 1000,
      "fee": 0,
      "realAmount": 1000,
      "payeeAcctNo": "VC960116",
      "depositTime": "2026-06-22 14:53:26"
    },
    {
      "orderNo": "IN<DEMO_ID>",
      "amount": 1000,
      "fee": 6,
      "realAmount": 994,
      "payeeAcctNo": "VA<DEMO_ID>",
      "depositTime": "2026-06-18 17:09:22"
    }
  ]
}

结果判定口径

公共状态：code=000000 表示接口请求处理成功；非 000000 时按 msg 排查签名、参数或业务校验问题。
业务数据：解析 bizData 后读取 total、page、pageSize 和 depositList。
记录范围：本接口只返回入金成功记录，不提供状态字段，也不支持按状态检索。
验签顺序：响应中返回 sign 时，先验签再解析和入库 bizData。
金额口径：amount、fee、realAmount 均以“分”为单位，展示时再转换为元。

错误处理

签名失败：核对 apiKey、signType、密钥、参数排序、bizData 字符串化方式和字符编码。
参数错误：重点检查 startDate、endDate、payeeAcctNo、page、pageSize。
日期范围错误：确认日期格式为 yyyy-MM-dd，且 startDate 到 endDate 的跨度不超过 1 个月。
查询为空：先确认入金账户号是否正确，再确认该时间范围内是否存在成功入金记录。
网络超时或响应未知：不要直接判定业务失败，可按相同查询条件稍后重试或在平台后台核实。

接入注意事项

reqId 应保证每次请求唯一，便于排查和幂等处理。
bizData 必须作为 JSON 字符串参与签名；实际请求体中不要传 appSecret。
生产环境与沙箱环境的应用、密钥和数据通常相互隔离，联调时请确认使用对应环境配置。
pageSize 取值范围为 1-100，未传时默认 10。
本接口返回字段不包含更新时间；如需同步增量数据，应以 depositTime 和查询窗口设计补偿策略。
入金金额、手续费、实际入账金额均按“分”处理，避免使用浮点数保存金额。

开户相关

开户变更

账户信息管理

消费转账

账户提现

异步通知

入金记录查询

接口说明

流程图

请求参数

响应参数

请求示例

响应示例

结果判定口径

错误处理

接入注意事项

接口说明 ​

流程图 ​

请求参数 ​

响应参数 ​

请求示例 ​

响应示例 ​

结果判定口径 ​

错误处理 ​

接入注意事项 ​

接口说明

流程图

请求参数

响应参数

请求示例

响应示例

结果判定口径

错误处理

接入注意事项