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 accounts by collection account number

Get all assigned dynamic FSDH 360 accounts by collection account number

Get all assigned dynamic FSDH360 account by collection account number

GET https://api-fsdh360-test.fsdhgroup.com/api/v1/virtualaccounts/dynamic/assigned/collectionaccount

To retrieve all assigned dynamic accounts by collection account number the below Query parameters should be provided.

Attention should be given to parameters marked *required.

Query Parameters

Name
Type
Description

Account number*

String

Clients account number

Skip

Int32

The number of records to skip

Take

Int32

The number of records to return

API-version

String

Version of API

[
  {
    "accountNumber": "string",
    "accountName": "string",
    "collectionAccountNumber": "string",
    "bvn": "string",
    "accountType": 1,
    "accountCurrency": "string",
    "hasExpired": true,
    "expires": "2022-12-07T10:04:07.974Z",
    "uniqueReference": "string",
    "isOneTimePaymentAccount": true,
    "expectedAmount": "string"
  }
]
{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "traceId": "00-f881b56e1be43847a304a72bc5addf53-adfaa7d7f33cfd4d-00",
  "errors": {
    "AccountNumber": [
      "Account number should be 10 digits long"
    ]
  }
}

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.

[
  {
    "accountNumber": "string",
    "accountName": "string",
    "collectionAccountNumber": "string",
    "bvn": "string",
    "accountType": 1,
    "accountCurrency": "string",
    "hasExpired": true,
    "expires": "2022-06-08T10:15:28.746Z",
    "uniqueReference": "string",
    "isOneTimePaymentAccount": true
  }
]
{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "traceId": "00-f881b56e1be43847a304a72bc5addf53-adfaa7d7f33cfd4d-00",
  "errors": {
    "AccountNumber": [
      "Account number should be 10 digits long"
    ]
  }
}
PreviousUnassigned dynamic accountsNextDynamic collection account balance

Last updated 2 years ago

Curl and Request URL
Server response