简体中文

English

简体中文

English

显示模式

关于 账户 ​

访问范围

需要多个访问范围—请参阅每个端点以了解访问范围要求。

需要访问受保护的客户数据。

资金账户是 GenPayment 的资金管理部分，提供了完整的资金管理能力，通过该模块，商户可以查询支付成功后每笔资金的来源和流向，实现资金精准管理。

核心概念

  • 资金账户：记录商户交易结算资金状态，包含结算中、已结算和已提现3部分资金信息。

核心功能

  • 查询资金账户：获取资金账户内各阶段的资金余额信息。包括币种、金额信息。
  • 查询资金明细：根据支付单查询每一笔资金走向（结算、提现等）。

接口

GET /api/202412/balance: 获取资金账户

资金账户 对象 ​

资金账户是 GenPayment 的核心能力，它提供了完整的资金管理能力，通过该模块，商户可以查询支付成功后每笔资金的来源和流向，实现资金精准管理。

属性 ​

balanceobject
财务账户。
- 收起属性
settlementedAmountstring
账户中已结算待提现的金额。
financeIdstring
财务账户唯一标识。
currencystring
资金的货币币种。
settlingAmountstring
交易完成、待结算金额。
bash
{
  "balance": {
    "settlingAmount": "123123",
    "settlementedAmount": "1000",
    "financeId": "FI123123",
    "currency": "USD"
  }
}

GET 获取资金账户 ​

获取店铺资金账户详情。

访问范围

需要以下任意访问权限: read_finance_account write_finance_account

接口

GET /api/202412/balance 

请求参数

{}

响应数据

balanceobject
财务账户。
- 收起属性
settlementedAmountstring
账户中已结算待提现的金额。
financeIdstring
财务账户唯一标识。
currencystring
资金的货币币种。
settlingAmountstring
交易完成、待结算金额。
bash
curl -X GET \ 
https://{shop}.genmystore.com/api/202412/balance" \ 
-H "X-Genstore-Access-Token: {access_token}" \
json
HTTP/1.1 200 OK
{
  "balance": {
    "settlingAmount": "123123",
    "settlementedAmount": "1000",
    "financeId": "FI123123",
    "currency": "USD"
  }
}