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

Transaction Status Codes

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 a list of errors that are returned by the provider when a transaction fails.

Transaction-Related Errors

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.

Status Code	Description	Action Required
000000	The transaction was successfully completed.	No action required
000001	The transaction is pending and 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.
000005	The transaction failed. This could be due to the errors described above.	Check if you have added all the valid payment information and contact us if it persists
000006	The transaction timed out. The transaction time was more than the 2-minute timeout set on our end. Once completed outside the 2-minute window, it will be changed to successful or failed.	Query transaction status after a few minutes to check if the status changed to success or failed. If not, please contact support for further assistance.

Get Started with Niobi

Collecting Payments

Making Payments

API Authentication

Transaction Status

Coverage

Going Live

Troubleshooting

Webhooks

Transaction Status Codes