导入
GPA 余额
了解通用账户(GPAs)及其余额,以及如何获取它们。
概述
通用账户(GPA) 是用户的默认账户。资金会从资金来源转入用户的GPA。
GPA余额类型
让我们看看用户或企业可用的不同类型的GPA余额:
-
在标准资金模式下,账簿余额 指的是可用资金金额,包括尚未清算的已授权交易资金。在即时(JIT)资金模式下,账簿余额 则指尚未清算、当前处于冻结状态的已授权资金。即时(JIT)资金模式允许在发生交易时,自动将项目资金来源中的资金转入相应账户。
-
可用余额 指的是用户的购买力。该金额等于账簿余额减去尚未清算的已授权交易金额。如果用户使用JIT资金,则此余额为 0.00。
-
待处理贷方 指的是已接受但仍在等待清算的入账。ACH(自动清算所)是美国银行网络使用的支付系统,交易在每天指定时间集中发送至网络进行清算。
-
缓存余额 和 信用余额 当前未使用。
获取GPA余额
我们可以通过向 {BASE_URL}/balances/{token} 端点发起 GET 请求来获取用户或企业的所有GPA余额。路径参数({token})表示我们要查询其GPA余额的用户或企业的令牌。该端点还会在响应中提供指向指定用户或企业GPA余额的链接。
路径参数
| 参数 | 类型 | 必需性 | 描述 |
|---|---|---|---|
| token | 字符串 | 必需 | 要查询其GPA余额的用户或企业的令牌 |
第1行: 我们使用保存的 USER_TOKEN 作为 token 的值,这是必需的路径参数。
点击下方代码框中的“运行”按钮以查看输出结果。
1token = '{{USER_TOKEN}}' 2 3url = '{{BASE_URL}}balances/' + token 4 5response = requests.get(url, headers=headers) 6 7printResponse(response)
当代码成功执行后,输出将显示对应于给定 token 的用户或企业的全部GPA余额,并提供访问链接。
若请求失败,则会显示相应的错误信息。