This section describes a list of errors that are returned by the provider when a transaction fails.

Transaction-Related Errors

Niobi

API Reference

Release Notes

Guides

Payment Portal

Support

Home

This section outlines the initial steps needed to begin using the Niobi Payments API.

Initial Steps

Getting Credentials

Collection Methods

Collect Payments

Make Payments

Authenticating API Requests

To maintain the Niobi payment system security and integrity, users are required to sign their request messages using their private key. By following these steps, you'll learn how to make a signature for your message and how Niobi checks that signature to make sure it's really from you. If the signature doesn't check out, Niobi won't accept the message.

Creating and Verifying Signatures

This section outlines the transaction status API, which allows you to query details of a specific transaction, including both payouts and deposits. Access the API endpoint [here](https://docs.niobi.co/api-reference/payment/niobi-get-transaction-status).

Verifying Transaction Status

This section outlines the supported countries that you can use while making a payment using Niobi's Payment API. Please note that all countries are available in  the sandbox environment. For production environment, only the countries you select will be available to you.

Supported Countries

This section outlines the transactions limit amounts while making a payment using Niobi's Payment API.

Transaction Limits

With Niobi's payment API, you'll get access to our sandbox environment, where you can safely test your integration with all available MNOs. Use special phone numbers (MSISDNs) to simulate different scenarios without involving real money or mobile wallets.

Testing our API

Once your sandbox testing has been successful for all endpoints, you are ready to go live.

Steps to Go Live

If you need to request a refund or reverse a transaction, you can easily initiate the process through the payment portal. Below are the steps and details about how refunds are handled.

Refund Requests

FAQs

HTTP Status Codes Overview

This section describes a list of errors caused by issues in the client's request, such as invalid data, missing fields, or insufficient permissions.

Client Errors

This section describes a list of errors related to security credentials while accessing the api endpoints.

Authentication Errors

This section describes a list of errors caused by issues on the server-side.

Server Errors

This section describes the transaction status codes you will expect once a transaction has been processed.

Transaction Status Codes

Our payments API uses callbacks to notify you of final statuses of payments.

Callback URLS

API Version 4 Release Notes

Niobi has a set of APIs which allows you to authenticate to the platform, accept payments from using payment links, make payments and viewing you account balance in your Niobi wallet

Introduction

need to get bearer token first to use niobi payment api

get-Token

Returns the status of a user by their email address, including KYC status information.

Get user status by email

This endpoint allows you to access a list of all the payment links created under your Niobi account.

Get Payment Links

Niobi create payment-link

Niobi STK Deposit

Niobi Unified Payment

This endpoint allows you to query your account balance.

Get Account Balance

This endpoint is for integration with Niobi. It generates signature used in the requests.

Generate Signature

This endpoint verifies the signature of a request to ensure its integrity and authenticity.

ERROR Code	Error Message	Action Required
400	This is more than maximum transaction value we allow in one transaction	Thetransaction amount exceeds the maximum allowable value. Ajust the amount and retry.
400	Please add funds to your account to cover this payment.	Top-up your wallet to be able to process the transaction.
400	One of the payment details entered is invalid. Please confirm again.	Check if you have added all the valid payment information.
400	The payment is still being processed. We request for your patience as we work to complete the process. Once completed, we will send an email notification.	Please wait patiently or contact us in case it is taking too long.
400	A similar payment is still being processed. Please confirm to avoid duplicating the payment.	A similar transaction is still being processed if it was not intentional you can just ignore this. However, if you want to perform the same transaction you can make the request again.
400	Your account does not have the rights to complete this payment. Please contact us for assistance.	This occurs when you have not fully submitted all the required KYC or the account is not verified. Please contact us for assistance.
400	Wait for some time and try again later	This might happen because of our providers downtimes. Please contact us for further support
400	We apologise as we were not able to process your payment request. Please try again later.	Please contact us.

Get Started with Niobi

Collecting Payments

Making Payments

API Authentication

Transaction Status

Coverage

Going Live

Troubleshooting

Webhooks

Transaction-Related Errors