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 BVN

Get all assigned dynamic FSDH 360 accounts by BVN

Get all assigned dynamic FSDH 360 accounts by BVN

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

To retrieve dynamic account details by BVN the below query parameters should be provided.

Attention should be given to parameters marked *required.

Query Parameters

Name
Type
Description

BVN*

String

Clients BVN

Skip

String

The number of records to skip

Take

String

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:12:48.440Z",
    "uniqueReference": "string",
    "isOneTimePaymentAccount": true,
    "expectedAmount": "string"
  }
]
Request Body
{
  "BVN": "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.

[
  {
    "accountNumber": "string",
    "accountName": "string",
    "collectionAccountNumber": "string",
    "bvn": "string",
    "accountType": 1,
    "accountCurrency": "string",
    "hasExpired": true,
    "expires": "2022-06-07T11:17:57.983Z",
    "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-5882c7f4999c0146881de12d515bf169-8cfd66e28b1f9940-00",
  "errors": {
    "BVN": [
      "BVN should be 11 digits long"
    ]
  }
}

PreviousDynamic collection account balanceNextGet a dynamic FSDH 360 account

Last updated 2 years ago

Curl and Request URL
Server response