{"id":898,"date":"2025-06-08T16:26:05","date_gmt":"2025-06-08T16:26:05","guid":{"rendered":"https:\/\/lddpay.com\/?post_type=docs&#038;p=898"},"modified":"2025-06-08T16:26:05","modified_gmt":"2025-06-08T16:26:05","password":"","slug":"balances","status":"publish","type":"docs","link":"https:\/\/lddpay.com\/zh\/docs\/balances\/","title":{"rendered":"Balances"},"content":{"rendered":"<h2 class=\"wp-block-heading\"><a href=\"file:\/\/\/C:\/Users\/Administrator\/Downloads\/payfac-doc (1).htm#tag\/Balances\/operation\/BalancesController_getEntityBalances\"><\/a>Retrieve entity balances<\/h2>\n\n\n\n<p>Retrieve balances for each sub-account (currency account) in an entity.<\/p>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary>Authorizations:<\/summary>\n<p><em>bearer<\/em><\/p>\n\n\n\n<h5 class=\"wp-block-heading\"><\/h5>\n\n\n\n<h5 class=\"wp-block-heading\">HTTP: bearer<\/h5>\n\n\n\n<p><strong>HTTP Authorization Scheme: <\/strong><code>bearer<\/code><\/p>\n\n\n\n<p><strong>Bearer format: <\/strong><code>JWT<\/code><\/p>\n<\/details>\n\n\n\n<h5 class=\"wp-block-heading\">path Parameters<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>idrequired<\/td><td>string Example: ent_w4jelhppmfiufdnatam37wrfc4The ID of the entity.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\">query Parameters<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>query<\/td><td>stringThe query to apply to limit the currency accounts. Example: currency:EUR<\/td><\/tr><tr><td>withCurrencyAccountId<\/td><td>boolean Default: false Example: withCurrencyAccountId=falseSpecifies if the response should include the sub-account ID that corresponds to each set of balances.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\">header Parameters<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>Authorizationrequired<\/td><td>string<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\">Responses<\/h5>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary>200 Balances retrieved successfully.<\/summary>\n<p>Array<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>currency required<\/td><td>stringThe currency of the sub-account.<\/td><\/tr><tr><td>available required<\/td><td>numberThe available balance.<\/td><\/tr><tr><td>pending required<\/td><td>numberThe pending balance.<\/td><\/tr><tr><td>reserved required<\/td><td>numberThe reserved balance.<\/td><\/tr><tr><td>total required<\/td><td>numberThe total balance.<\/td><\/tr><tr><td>entity_id required<\/td><td>stringThe entity ID.<\/td><\/tr><tr><td>currency_account_id<\/td><td>stringThe sub-account ID (currency account ID).<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary>400 Query format not supported<\/summary>\n<h5 class=\"wp-block-heading\">Response Schema: application\/json<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>request_id required<\/td><td>stringThe unique request identifier.<\/td><\/tr><tr><td>error_type required<\/td><td>stringThe error type.<\/td><\/tr><tr><td>error_codes required<\/td><td>Array of stringsThe error codes.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>\n\n\n\n<p>401 Unauthorized<\/p>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary>404 Entity not found<\/summary>\n<h5 class=\"wp-block-heading\">Response Schema: application\/json<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>request_id required<\/td><td>stringThe unique request identifier.<\/td><\/tr><tr><td>error_type required<\/td><td>stringThe error type.<\/td><\/tr><tr><td>error_codes required<\/td><td>Array of stringsThe error codes.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary>422 Invalid data was sent<\/summary>\n<h5 class=\"wp-block-heading\">Response Schema: application\/json<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>request_id required<\/td><td>stringThe unique request identifier.<\/td><\/tr><tr><td>error_type required<\/td><td>stringThe error type.<\/td><\/tr><tr><td>error_codes required<\/td><td>Array of stringsThe error codes.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>","protected":false},"excerpt":{"rendered":"<p>Retrieve entity balances Retrieve balances for each sub-account (currency account) in an entity. path Parameters idrequired string Example: ent_w4jelhppmfiufdnatam37wrfc4The ID [&hellip;]<\/p>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"doc_category":[122],"doc_tag":[],"year_month":"2026-04","word_count":192,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"author_nicename":"admin","author_url":"https:\/\/lddpay.com\/zh\/author\/admin\/"},"doc_category_info":[{"term_name":"Temp Solution","term_url":"https:\/\/lddpay.com\/zh\/docs-category\/temp-solution\/"}],"doc_tag_info":[],"author_list":[{"ID":"3","user_login":"jony","display_name":"jony","id":"3"},{"ID":"2","user_login":"Merchantlogin","display_name":"Merchantlogin","id":"2"},{"ID":"1","user_login":"w2863431","display_name":"admin","id":"1"}],"_links":{"self":[{"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/docs\/898"}],"collection":[{"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/comments?post=898"}],"version-history":[{"count":1,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/docs\/898\/revisions"}],"predecessor-version":[{"id":899,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/docs\/898\/revisions\/899"}],"wp:attachment":[{"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/media?parent=898"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/doc_category?post=898"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/doc_tag?post=898"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}