账户类接口

查询子账户余额信息

场景：查询虚拟子账户余额信息，包括账户金额、在途交易金额、累计转入和支出金额。

调用方法B2SVirtualAccounts.info

SDK 示例（Java）

import com.gc365.sznr.sdk.api.b2s.B2SVirtualAccounts;
import com.gc365.sznr.sdk.model.b2s.VirtualAccountInfoParam;

VirtualAccountInfoParam param = VirtualAccountInfoParam.builder()
    // 设置查询参数
    .build();

VirtualAccountInfoResult result = B2SVirtualAccounts.info(param);

POST/open-api/geo-agri-center/virtual-account/info

请求参数 Body

enterpriseNamestring必需

企业名称

响应参数

codeinteger必需

响应码，200 表示成功

msgstring必需

响应消息

dataobject必需

账户信息

enterpriseNamestring必需

企业名称

accountLimitinteger必需

账户金额

inTransitAmountinteger必需

在途交易金额

totalIncomeAmountinteger必需

累计转入金额

totalExpenseAmountinteger必需

累计支出金额

子账户预充值金额退还

场景：申请将子账户中的预充值金额退还到指定银行账户。

调用方法B2SVirtualAccounts.returnAmount

SDK 示例（Java）

import com.gc365.sznr.sdk.api.b2s.B2SVirtualAccounts;
import com.gc365.sznr.sdk.model.b2s.VirtualAccountReturnParam;

VirtualAccountReturnParam param = VirtualAccountReturnParam.builder()
    // 设置退还参数
    .build();

VirtualAccountReturnResult result = B2SVirtualAccounts.returnAmount(param);

POST/open-api/geo-agri-center/virtual-account/return

请求参数 Body

enterpriseNamestring必需

企业名称

returnAmountnumber必需

返还金额

范围 (0.01, 9999999999.99]

returnBankAccountNostring必需

返还银行账户号

externalReturnApplyNostring必需

外部退还申请号，回调时返回

bankCodestring可选

银行开户行号，若不填则需账号有预充值记录

bankNamestring可选

开户行行名，若不填则需账号有预充值记录

响应参数

codeinteger必需

响应码

msgstring必需

响应消息

dataobject必需

退还结果

transactionNostring可选

申请退还交易流水号

errorCodestring可选

业务错误码

stackTraceStringstring可选

堆栈异常信息

查询预充值金额退还结果

场景：查询子账户预充值金额退还的处理结果，通过外部退还申请号或交易流水号查询。

调用方法B2SVirtualAccounts.returnQuery

SDK 示例（Java）

import com.gc365.sznr.sdk.api.b2s.B2SVirtualAccounts;
import com.gc365.sznr.sdk.model.b2s.VirtualAccountReturnQueryParam;

VirtualAccountReturnQueryParam param = VirtualAccountReturnQueryParam.builder()
    // 设置查询参数
    .build();

VirtualAccountReturnQueryResult result = B2SVirtualAccounts.returnQuery(param);

POST/open-api/geo-agri-center/virtual-account/return-query

请求参数 Body

externalReturnApplyNostring可选

外部退还申请号（与 transactionNo 至少传一个）

transactionNostring可选

申请退还交易流水号（与 externalReturnApplyNo 至少传一个）

响应参数

codeinteger必需

响应码

msgstring必需

响应消息

dataobject必需

退还结果详情

transactionNostring可选

交易流水号

enterpriseNamestring可选

企业名称

returnAmountnumber可选

退还金额

returnTimestring可选

退还时间

returnBankAccountNostring可选

退还账号

returnStatusstring可选

退还状态

notifyTimestring可选

通知时间

externalReturnApplyNostring可选

外部退费申请单号

errorCodestring可选

业务错误码

stackTraceStringstring可选

堆栈异常信息

充值入账通知

场景：接收第三方资金变化通知，更新虚拟账户余额信息，并返回更新后的账户信息。需三方配置接口地址。

注意：此接口已废弃。

POST/open-api/geo-agri-center/virtual-account/recharge-notify

请求参数 Body

transactionNostring必需

交易流水号

enterpriseNamestring必需

付款方名称

rechargeAmountnumber必需

充值金额

rechargeTimestring必需

充值时间

counterpartAccountNostring必需

付款方银行账号

counterpartBankNamestring必需

付款方银行名称

remarkstring必需

备注信息

notifyTimestring必需

通知时间

响应参数

codeinteger必需

响应码

msgstring可选

响应消息