UfitPay API is designed for developers to easily integrate various payment functionality on any application using any software programing technology or development platform
Our API attempts to conform to the RESTful design principles. You interact with the resources exposed through the API by accessing resource collection and element URIs using the HTTP POST or GET.
Access to our API is Freely available to all registered UfitPay customers, agents, merchants and vendors. You will likely need access to an Experienced web developer or programmer (if you’re not one) to get the most use out of UfitPay API.
In order to interact with UfitPay Wallet-based API services, you need to enable API access on your account. To do this, go to Account Settings on the UfitPay Mobile App then click the Generate API Keys link. We will generate and send new API credentials to your registered email address;
Once generated, you will be able to retrieve your API credentials at any time by the View API keys link.
For added security, we recommend you restrict access to your API credentials to only white-listed IP addresses. You can do this by clicking the Restrict API Access link under Account Settings on UfitPay Mobile App.
In order to interact with UfitPay Merchant/Vendors API services, you need to enable API access on your merchant/vendors dashboard. This is usually enabled by default. To do this, go to Vendors Settings from your UfitPay Merchant Dashboard then click the API Settings tab to view your API credentials.
You can also generate new API keys by clicking the Generate New keys button.
It is posible to access UfitPay wallet API services using your Merchant/Vendors API credentails. This feature comes handy when you prefer a flow that uses a single authentication accross all your API calls.
To use this feature, you will need to connect a verified UfitPay Business Account (Wallet) to your merchant account. You can Sign-up a Business Account here if you don't have one already.
Go to Vendors Settings from your UfitPay Merchant Dashboard, then click on API Settings tab to managed your connected wallets.
Once a UfitPay wallet is connected to your merchant account, all chargeable API requests will be billed from the wallet. Please note that Settlement Wallet is not the same as a Connected Wallet. If you wish to use same UfitPay wallet as both merchant settlement destination and wallet API access, you will need to connect the wallet folloing the step above
UfitPay API URL is made up of the Base URL and the Resource URI. A complete API URL will look like this;
All requests to UfitPay API require authentication. Our API Authentication is implemented as HTTP Header Authentication over TLS (HTTPS).
To authenticate your request, you need to pass the following parameters as part of your HTTP request headers;
Api-Key: Your account API key
Api-Token: Your account API token
Please note that all API requests to the Wallet Endpoints must be authenticated using valid Wallet API credentials, while requests to Merchant / Vendors Endpoints must be autheticated using valid Merchant API credentials.
UfitPay API accepts only Form Encoded HTTP POST or GET requests, depending on which resource you want to access. Any other request method will not be recognized by our API
Below is a sample request to our balance enquiry API using cURL;
curl --request POST \
--url 'https://api.ufitpay.com/v1/balance' \
--header 'Api-Key: 1234567890' \
--header 'Api-Token: 33gTuienGR83HY32cGt' \
--header 'content-type: application/x-www-form-urlencoded'
UfitPay API response (success or error) is returned in JSON data. Response codes are sent via the normal HTTP Response Code,
A success response from our server will look like this;
An error response from our server will look like this;
"message":"Invalid API credentials"
|This is the API resource being called
|This is status of the API call. This is not thesame as the actual transaction status which can only be found within the "data" object
|This object holds more information about the request. The content of this parameter depends on which API endpoint is being called
The following API Credentials can be used for development and test purpose only. Transactions done using these credentials are not treated as live
|Wallet API Key
|Wallet API Token
|Merchants/Vendor API Key
|Merchants/Vendor API Token
|NUBAN Account Number
|Internet Banking Username
|Internet Banking Password
|PIN / OTP / Token
|Card Holder ID
Explore UfitPay's Fintech API Product Offerings to unlock powerful and seamless payment experiences
Interact with & control your UfitPay wallet securely using our wallet APIs
Interact with the various UfitPay wallet payment services securely using our Bill Payment APIs
Interact with the various UfitPay fund transfer services securely using our Bank Transfer APIs
Interact with UfitPay Virtual Banking & Account services securely with our Virtual banking APIs
Interact with UfitPay merchant payment as well as Vendors services securely with our Merchant APIs
Securly access your customer's account & financial information from banks with our financial data APIs
Generate virtual Naira and US Dollar cards for your customers to make payments with our virtual card APIs
Interact with various UfitPay Identiti Verification services securely with our ID Verification APIs
Receive real-time updates on your API requests with our Webhook & instant notification features