登记簿提现

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

概述

本文按 APP 支付接口模版整理，保留原接口字段含义，并统一补充签名说明、正式/沙箱示例、多语言请求示例和结果判定口径。

接口说明

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

接口名称	登记簿提现
请求方式	POST
正式地址	https://pay.rscygroup.com/api/open/virtualBank/account/withdraw
沙箱地址	https://pay-test.rscygroup.com/api/open/virtualBank/account/withdraw
签名方式	MD5 ，按签名规则说明生成或校验 sign
结果判定	先判断公共返回 code，成功后验签并解析 bizData；最终业务状态以业务字段、查询接口或异步通知为准

流程图

处理要点：

请求前先将业务字段组装为 bizData JSON 字符串，再和公共参数一起参与签名。
响应或通知包含 sign 时，应先按签名规则验签，再解析 bizData。
code=000000 表示接口请求处理成功，不等同于所有异步业务流程最终完成。

请求参数

应用场景

虚拟银行记账簿资金可以调用当前接口提现到银行卡
提现成功会打款到开户的时候传入的结算卡中(如果绑定的是对公则打款到对公，对私则打款到对私)

字段名	变量名	必填	类型	示例值	描述
外部订单号	outOrderNo	是	String	AT12123123	接口订单号最大长度不超过32位
账户号	acctNo	是	String	AC123123	登记薄账户号
提现金额	amount	是	Long	200	提现金额(单位分，保留整数)示例：100 表示 1元
渠道扩展参数	channelExtra	否	String	-	渠道扩展参数(开户默认为免密模式)签约提现免密后当前参数无需传
备注	remark	否	String	-	备注

字段名	变量名	必填	类型	示例值	描述
短信验证码	smsCode	否	String	260715	短信验证码调用短信验证码接口会返回签约提现免密后当前参数无需传
短信流水号	smsFlowNo	否	String	XS<DEMO_ID>	短信流水号调用短信验证码接口会返回签约提现免密后当前参数无需传
收款账户号	recvAcctNo	否	String	-	收款账户号限定绑定账户或白名单账户，如果不上送，则取绑定账户。
收款账户名称	recvAcctName	否	String	-	收款账户名称

text

{
  "reqId": "<DEMO_ID>",
  "reqTime": "<DEMO_ID>",
  "version": "1.0",
  "signType": "MD5",
  "apiKey": "<DEMO_ID>",
  "bizData": "{\"outOrderNo\":\"CA<DEMO_ID>\",\"acctNo\":\"121231\",\"amount\":1000,\"remark\":\"12312\"}",
  "sign": "<SIGNATURE>"
}

响应参数

字段名	变量名	必填	类型	示例值	描述
外部订单号	outOrderNo	是	String	AT12123123	外部订单号最大长度不超过32位
平台单号	orderNo	是	String	SA12312312	平台订单号
账户号	acctNo	是	String	AC123123	登记薄账户号
状态	state	是	Number	INIT	状态INIT：初始化PROCESSING：处理中SUCCESS：成功FAIL：失败
提现金额	amount	是	Long	100	提现金额(单位分，保留整数)示例：100 表示 1元
手续费	mchFee	是	Long	100	手续费(单位分，保留整数)示例：100 表示 1元
手续费扣费方式	feeType	是	String	ACCOUNT	续费扣费方式ORDER- 订单内扣；ACCOUNT - 外扣
入账金额	realAmount	是	Long	100	入账金额(单位分，保留整数)示例：100 表示 1元如果手续费为ACCOUNT外扣模式则提现金额和入账金额保持一致，手续费从外部扣除如果手续费为ORDER内扣模式则提现金额和入账金额不一致，手续费从提现金额中扣除
描述	note	否	String	描述	当有报错返回时候会返回报错信息

请求示例

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

bash

curl -X POST "https://pay.rscygroup.com/api/open/virtualBank/account/withdraw" \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "<CONFIGURED_VALUE>",
    "bizData": "{\"outOrderNo\":\"OUTORDERNO<DEMO_ID>\",\"String\":\"StringValue\",\"AT12123123\":\"AT12123123Value\",\"acctNo\":\"ACCTNO<DEMO_ID>\",\"AC123123\":\"AC123123Value\",\"amount\":100,\"Long\":\"LongValue\",\"channelExtra\":\"channelExtraValue\",\"remark\":\"remarkValue\",\"smsCode\":\"cbhbCht\"}",
    "sign": "<按签名规则生成>",
    "signType": "MD5",
    "reqId": "WITHDRAW<DEMO_ID>",
    "reqTime": "<DEMO_ID>",
    "version": "1.0"
  }'

bash

curl -X POST "https://pay-test.rscygroup.com/api/open/virtualBank/account/withdraw" \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "<CONFIGURED_VALUE>",
    "bizData": "{\"outOrderNo\":\"OUTORDERNO<DEMO_ID>\",\"String\":\"StringValue\",\"AT12123123\":\"AT12123123Value\",\"acctNo\":\"ACCTNO<DEMO_ID>\",\"AC123123\":\"AC123123Value\",\"amount\":100,\"Long\":\"LongValue\",\"channelExtra\":\"channelExtraValue\",\"remark\":\"remarkValue\",\"smsCode\":\"cbhbCht\"}",
    "sign": "<按签名规则生成>",
    "signType": "MD5",
    "reqId": "WITHDRAW<DEMO_ID>",
    "reqTime": "<DEMO_ID>",
    "version": "1.0"
  }'

复用签名规则说明中的 genSign / verifySign 通用方法。

java

Map<String, Object> biz = new LinkedHashMap<>();
biz.put("outOrderNo", "OUTORDERNO<DEMO_ID>");
biz.put("String", "StringValue");
biz.put("AT12123123", "AT12123123Value");
biz.put("acctNo", "ACCTNO<DEMO_ID>");
biz.put("AC123123", "AC123123Value");
biz.put("amount", 100);
biz.put("Long", "LongValue");
biz.put("channelExtra", "channelExtraValue");
biz.put("remark", "remarkValue");
biz.put("smsCode", "cbhbCht");

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

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

php

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

$biz = [
    'outOrderNo' => 'OUTORDERNO<DEMO_ID>',
    'String' => 'StringValue',
    'AT12123123' => 'AT12123123Value',
    'acctNo' => 'ACCTNO<DEMO_ID>',
    'AC123123' => 'AC123123Value',
    'amount' => 100,
    'Long' => 'LongValue',
    'channelExtra' => 'channelExtraValue',
    'remark' => 'remarkValue',
    'smsCode' => 'cbhbCht',
];

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

python

biz = {
    'outOrderNo': 'OUTORDERNO<DEMO_ID>',
    'String': 'StringValue',
    'AT12123123': 'AT12123123Value',
    'acctNo': 'ACCTNO<DEMO_ID>',
    'AC123123': 'AC123123Value',
    'amount': 100,
    'Long': 'LongValue',
    'channelExtra': 'channelExtraValue',
    'remark': 'remarkValue',
    'smsCode': 'cbhbCht',
}
req = {
    'apiKey': '<API_KEY>',
    'bizData': json.dumps(biz, ensure_ascii=False),
    'reqId': f'WITHDRAW{int(time.time())}',
    'reqTime': '<DEMO_ID>',
    'signType': 'MD5',
    'version': '1.0',
}
req['sign'] = gen_sign(req, 'MD5')

javascript

const biz = {
  "outOrderNo": "OUTORDERNO<DEMO_ID>",
  "String": "StringValue",
  "AT12123123": "AT12123123Value",
  "acctNo": "ACCTNO<DEMO_ID>",
  "AC123123": "AC123123Value",
  "amount": 100,
  "Long": "LongValue",
  "channelExtra": "channelExtraValue",
  "remark": "remarkValue",
  "smsCode": "cbhbCht",
};
const req = {
  apiKey: '<CONFIGURED_VALUE>',
  bizData: JSON.stringify(biz),
  reqId: 'WITHDRAW' + Date.now(),
  reqTime: '<DEMO_ID>',
  signType: 'MD5',
  version: '1.0',
};
req.sign = genSign(req, 'MD5');

响应示例

json

{
  "code": "000000",
  "msg": "请求成功",
  "timestamp": "<DEMO_ID>",
  "sign": "<SIGNATURE>",
  "signType": "MD5",
  "bizData": "{\"acctNo\":\"123123\",\"amount\":100,\"fee\":0,\"feeType\":\"ACCOUNT\",\"orderNo\":\"1233123\",\"outOrderNo\":\"123123\",\"realAmount\":100,\"state\":\"SUCCESS\"}"
}

结果判定口径

公共状态：code=000000 表示接口请求处理成功；非 000000 时按 msg 排查签名、参数或业务校验问题。
业务状态：如响应 bizData 内存在 state、status、result、batchNo、orderNo、reqNo 等字段，应以对应业务字段作为后续处理依据。
验签顺序：响应或通知中返回 sign 时，先验签再解析和入库 bizData。
异步场景：同步成功通常只代表请求受理，最终结果以回调通知或查询接口为准。

错误处理

签名失败：核对 apiKey、signType、密钥、参数排序、bizData 字符串化方式和字符编码。
参数错误：按本页请求参数表检查必填项、枚举值、金额单位、时间格式和单号唯一性。
业务失败：读取 code、msg 和 bizData 内业务字段，按接口语义修正后再重试。
网络超时或响应未知：不要直接判定业务失败，使用查询接口或平台后台核实后再处理。

接入注意事项

reqId 应保证每次请求唯一，便于排查和幂等处理。
bizData 必须作为 JSON 字符串参与签名；实际请求体中不要传 appSecret。
生产环境与沙箱环境的应用、密钥和数据通常相互隔离，联调时请确认使用对应环境配置。
金额字段如无特殊说明，按源文档口径以“分”为单位。
字段枚举、状态流转和条件必填规则以本页参数说明为准；源文档未说明的场景请联系平台确认。

开户相关

开户变更

账户信息管理

消费转账

账户提现

异步通知

登记簿提现

概述

接口说明

流程图

请求参数

响应参数

请求示例

响应示例

结果判定口径

错误处理

接入注意事项

概述 ​

接口说明 ​

流程图 ​

请求参数 ​

响应参数 ​

请求示例 ​

响应示例 ​

结果判定口径 ​

错误处理 ​

接入注意事项 ​

概述

接口说明

流程图

请求参数

响应参数

请求示例

响应示例

结果判定口径

错误处理

接入注意事项