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. Integration Guide

Response Codes

The API Uses HTTP Status codes to communicate the result of a requested operation, the table below gives a list of status codes used.

PreviousTest ParametersNextAuthentication

Last updated 2 years ago

Response Code
Description

200

OK - Action completed successfully

201

Created - create or update action completed successfully

204

No content - Delete or unlink action complete successfully

400

Bad request - Invalid or incomplete request parameters

401

Client needs to authorize with the authorization server and provide a valid access token

403

Forbidden - Client is not allowed to carry out requested action

404

Not found - The requested resource was not found

500

Internal server error

Find in the table below the response codes applicable to and their respective descriptions:

Codes
Descriptions

00

Approved or completed successfully

01

Status unknown, please wait for settlement report

03

Invalid Sender

05

Do not honor

06

Dormant Account

07

Invalid Account

08

Account Name Mismatch

09

Request processing in progress

12

Invalid transaction

13

Invalid Amount

14

Invalid Batch Number

15

Invalid Session or Record ID

16

Unknown Bank Code

17

Invalid Channel

18

Wrong Method Call

21

No action taken

25

Unable to locate record

26

Duplicate record

30

Format error

34

Suspected fraud

35

Contact sending bank

51

No sufficient funds

57

Transaction not permitted to sender

58

Transaction not permitted on channel

61

Transfer limit Exceeded

63

Security violation

65

Exceeds withdrawal frequency

68

Response received too late

69

Unsuccessful Account/Amount block

70

Unsuccessful Account/Amount unblock

71

Empty Mandate Reference Number

91

Beneficiary Bank not available

92

Routing error

94

Duplicate transaction

96

System malfunction

97

Timeout waiting for response from destination

F9

Unable to debit customer

-1

Transaction Pending

Transaction Errors

Error Message
Occurs When
Next Step

Client is not authorized to perform operations on this account

Client isn't logged in with accurate credentials

Confirm login credentials supplied by the bank, refresh page and try logging in again

FSDH Pay