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
  • Authentication with Curl
  • Authentication with Postman
  • Authentication with Powershell - Rest method
  • API Authorization
  1. Integration Guide

Authentication

Default headers which should be included in the API request.

PreviousResponse CodesNextBest Practices

Last updated 2 years ago

Request are authenticated using Bearer tokens. We provide a token for the requests, these tokens are used in API Calls , developers should also use http status to know the result of an API call .

Authorization headers should be in the following format: Authorization: Bearer token . Pass your secret key as a bearer token in the request header to authorize all requests.

Authentication with Curl

curl --location --request POST 'https://idp-test.fsdhgroup.com/connect/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'client_id=test-client' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_secret=secret'// Some code

Authentication with Postman

Authentication with Powershell - Rest method

$headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
$headers.Add("Content-Type", "application/x-www-form-urlencoded")

$body = "client_id=test-client&grant_type=client_credentials&client_secret=secret"

$response = Invoke-RestMethod 'https://idp-test.fsdhgroup.com/connect/token' -Method 'POST' -Headers $headers -Body $body
$response | ConvertTo-Json

API Authorization

All API calls on FSDH are authenticated. API requests made without authorization will fail with the status code 401: Unauthorized.

Your secret key can perform any transactions on your FSDH account without restriction.

To authorize API calls from your server, pass your secret key as a bearer token. This means passing an Authorization header with a value of "Bearer: YOUR_SECRET_KEY".

Authenticate against the Identity provider
Using postman to retrieve access token