查看您的余额

本指南介绍了如何查看您 Currencycloud 账户中持有的各种外币金额。

工作流程图

集成指南

第 1 步：登录

请参阅验证指南，获取开始新 API 会话的说明。

第 2 步：查看特定货币的余额

要查看您在 Currencycloud 主账户中的欧元余额，调用 Get Balance 端点 - /v2/balances/{currency},，并传递 EUR 作为货币参数。

GET /v2/balances/EUR
X-Auth-Token: ea6d13c7bc50feb46cf978d137bc01a2

以下响应显示您的 Currencycloud 主账户中有 €15,458.12。

HTTP/1.1 200 OK
Content-Type: application/json
{
  "id": "ad6411db-1e00-44fd-b4e8-194c74cf2f83",
  "account_id": "d22073a6-4c56-4980-8699-504b0c70003f",
  "currency":"EUR",
  "amount":"15458.12",
  "created_at":"2021-12-10T16:05:20+00:00",
  "updated_at":"2021-12-10T16:05:20+00:00"
}  

要获取终端客户子账户的余额，只需通过 on_behalf_of 查询字符串参数提供子账户 UUID 即可。

GET /v2/balances/EUR?on_behalf_of=d5eba0d5-ef7e-48c9-9a19-44638e2470c2
X-Auth-Token: ea6d13c7bc50feb46cf978d137bc01a2

第 3 步：获取详细货币余额

另外，使用 Find Balances 端点 /v2/balances/find 可以查询您在 Currencycloud 主账户中持有的所有外币余额。

GET /v2/balances/find
X-Auth-Token: ea6d13c7bc50feb46cf978d137bc01a2  

以下响应显示您在 Currencycloud 主账户中持有 £10,750.00、US$1,500.24 和 €15,458.12。

{
  "balances": [
    {
      "id": "c52128a4-3918-40dc-a92a-7225cef3a4a6",
      "account_id": "d22073a6-4c56-4980-8699-504b0c70003f",
      "currency":"GBP",
      "amount":"10750.00",
      "created_at":"2021-12-10T16:05:19+00:00",
      "updated_at":"2021-12-10T16:05:19+00:00"
    },
    {
      "id":"349a2b87-9455-4808-9e68-515daf1f7298",
      "account_id": "d22073a6-4c56-4980-8699-504b0c70003f",
      "currency":"USD",
      "amount":"1550.24",
      "created_at":"2021-12-10T16:05:19+00:00",
      "updated_at":"2021-12-10T16:05:19+00:00"
    },
    {
      "id": "ad6411db-1e00-44fd-b4e8-194c74cf2f83",
      "account_id": "d22073a6-4c56-4980-8699-504b0c70003f",
      "currency":"EUR",
      "amount":"15458.12",
      "created_at":"2021-12-10T16:05:20+00:00",
      "updated_at":"2021-12-10T16:05:20+00:00"
    }
  ],
  "pagination": {
    "total_entries":3,
    "total_pages":1,
    "current_page":1,
    "per_page":25,
    "previous_page": -1,
    "next_page": -1,
    "order": "created_at",
    "order_asc_desc": "asc"
  }
}   

要获取您任何客户子账户的余额，只需通过 on_behalf_of 查询字符串参数提供子账户 UUID 即可。有关使用 on_behalf_of 的更多信息，请参阅我们的子账户活动指南。

GET /v2/balances/find?on_behalf_of=d5eba0d5-ef7e-48c9-9a19-44638e2470c2
X-Auth-Token: ea6d13c7bc50feb46cf978d137bc01a2