FSDH Developer Documentation
Create a Support TicketFSDH Merchant Bank
  • Getting Started
    • Overview
    • Quick Start
  • Integration Guide
    • Base URLs
    • Merchant Web Hook
    • Test Parameters
    • Response Codes
    • Authentication
  • Going Live
    • Best Practices
    • Going Live
      • Go-Live Schedule
  • FSDH 360
    • Dynamic Virtual Accounts
      • Assigned dynamic accounts
      • Unassigned dynamic accounts
      • Dynamic accounts by collection account number
      • Dynamic collection account balance
      • Dynamic accounts by BVN
      • Get a dynamic FSDH 360 account
      • Create a Dynamic Virtual Account
      • Update dynamic account
      • Unassign dynamic account
      • Transaction history
    • Static Virtual Accounts
      • Get static FSDH 360 accounts
      • Create static virtual accounts
      • Update static account
      • Get a static account
      • Link static to collection account
      • Query collection account balance
      • Link static accounts to BVN
      • Virtual account transaction history
    • Merchant Virtual Codes
      • Merchant Codes by notification styles
      • Merchant Codes by commission deduction types
      • Merchant Codes by authorization types
      • Account enquiry
      • Create merchant virtual codes
      • Get merchant virtual code
      • Update merchant code
      • Get merchant by code
      • Pending merchant codes
      • Authorized merchant codes
      • Rejected merchant codes
      • Download merchant codes
      • Update authorized merchant codes
      • Update rejected merchant codes
      • Merchant codes for account collection
      • Merchant codes by collection account
      • Update merchant codes for collection account
      • Link merchant codes to collection accounts
      • Pending merchant codes collection account
      • Authorized merchant codes collection account
      • Rejected merchant codes collection account
      • Deleted merchant codes collection account
      • Delete merchant codes for a collection account
      • Authorize merchant codes for a collection account
      • Reject merchant codes for a collection account
      • Get all merchant codes
    • Error Response Codes
  • FSDH Pay
    • FSDH PAY
      • Balance enquiry
      • Banks list
      • Funds Transfer
        • Transfer query
        • Funds Transfer History
        • Perform Transfers
      • Name Enquiry
        • Name enquiry (FSDH)
        • Name enquiry (NIP)
  • FSDH Identity
    • FSDH Identity
      • Multiple BVN
      • Single BVN
        • Send OTP
        • Validate OTP
        • Birthday date
        • Get single BVN
      • BVN watch list check
      • Verify multiple BVN
      • Verify single BVN
        • Verify single BVN using birth date
  • Product Update
    • Upcoming changes
      • Change log
  • Contact Us
    • 📞Contact us
Powered by GitBook
On this page
  1. FSDH 360
  2. Dynamic Virtual Accounts

Dynamic collection account balance

Query balance for collection account

PreviousDynamic accounts by collection account numberNextDynamic accounts by BVN

Last updated 2 years ago

Query balance for a collection account

POST https://api-fsdh360-test.fsdhgroup.com/api/v1/virtualaccounts/dynamic/collectionaccount/balance

To retrieve account balance for a collection account the below parameters should be provided.

Attention should be given to parameters marked *required.

Query Parameters

Name
Type
Description

API-version

String

Version of API

Request Body

Name
Type
Description

Account Number*

String

Client's account number

{
  "availableBalance": 0,
  "ledgerBalance": 0
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}
Request body
{
  "accountNumber": "string"
}

Response Body

Inputting the correct parameters should give you a 200: Success response which will populate the below Success details. Also specified are possible responses from the request.

{
  "availableBalance": 0,
  "ledgerBalance": 0
}
{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.4",
  "title": "Not Found",
  "status": 404,
  "traceId": "00-91c82e973fbcf54b87d54a3e5408b760-295382d932e2fd48-00"
}s
{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.6.1",
  "title": "An error occurred while processing your request.",
  "status": 500,
  "traceId": "00-0cb6212be57bd64c8b036f5190557edf-a5e21ee317c93742-00"
}
Curl and Request URL
Server response