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

Authentication 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 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

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
403	You are restricted to access the site. Contact to Niobi support for further information.	Your ip addresss is not yet whitelisted with us. Contact us with a list of your ips for whitelisting at support@niobi.co
403	Request was not verified	Make sure you are using the correct payload and signature which were previously signed

Get Started with Niobi

Collecting Payments

Making Payments

API Authentication

Transaction Status

Coverage

Going Live

Troubleshooting

Webhooks

Authentication Errors