Submit Niobi Unified Payments

POST

api

niobi-unified-payments

object

client_id

string

params

object

amount

integer

customer_identifier

integer

currency

string

payment_reference

string

first_name

string

last_name

string

mobile

string

country_id

integer

city

string

postal_code

string

line1

string

description

string

client_callback_url

string

third_party_reference_1

string

third_party_reference_2

string

payment_method_type

enum<string>

mtn

array

Orange

array

Vodacom

array

Airtel

array

Vodafone

array

tnm

array

Zamtel

array

Halotel

array

Tigo

array

Free

array

sendmoney

array

paybill

array

tillnumber

array

pesalink

array

salt

string

sender

string

timestamp

integer

signature

string

Please make sure to generate a new signature whenever you are creating a new payment.

List of Supported Countries

Country Id	Country	Country Code	Currency	Payment Method type	Required Fields
1	Kenya	254	KES	till number, pay bill, pesalink, send money	country_id, currency
2	Benin	229	XOF	mtn	country_id, currency
3	Cote D’Ivoire	225	XOF	mtn, Orange	country_id, currency
4	Cameroon	237	XAF	mtn, Orange	country_id, currency
5	DRC	243	CDF	Orange, Airtel, Vodacom	country_id, currency
7	Malawi	265	MWK	Airtel, tnm	country_id, currency
8	Rwanda	250	RWF	mtn, Airtel	country_id, currency
9	Senegal	221	XOF	Orange, Free	country_id, currency
10	Tanzania	255	TZS	Airtel, Halotel, Tigo	country_id, currency
11	Uganda	256	UGX	mtn, Airtel	country_id, currency
12	Zambia	260	ZMW	Zamtel, mtn, Airtel	country_id, currency
13	Sierra Leone	232	SLE	Orange	country_id, currency

List of supported pesalink banks

id	bank_name	niobi_bank_code
1	Kenya Commercial Bank	1
2	Standard Chartered	2
3	Absa Bank Kenya	3
4	Ncba Bank Kenya	7
5	Prime Bank	10
6	Cooperative Bank	11
7	National Bank of Kenya	12
8	Citibank N.A Kenya	16
9	Middle East Bank Kenya	18
10	Bank of Africa Kenya	19
11	Credit Bank Limited	25
12	CFC Stanbic Kenya	31
13	Paramount Bank	50
14	Jamii Bora Bank	51
15	Guaranty Trust Bank	53
16	Guardian Bank	55
17	I&M Bank	57
18	Diamond Trust Bank	63
19	Sidian Bank	66
20	Equity Bank Kenya	68
21	Family Bank Limited	70
22	Gulf African Bank	72
23	First Community Bank	74
24	Kenya Women’s Finance Trust	78

Body

application/json

client_id

string

required

The Client id is your public key which is generated when you are creating a new API integration from our app.

params

object

required

params.amount

integer

required

The amount to be transferred. Please note this value should be in standard units(x100)

params.currency

string

required

Currency of the transaction.

params.payment_reference

string

required

Any information you can use to reference this transaction later.

params.first_name

string

required

First name of the payee.

params.last_name

string

required

Last name of the payee.

params.mobile

string

required

Mobile number of the payee.

params.email

string

required

Email of the payee.

params.country_id

integer

required

Country Id can be used from above table.

params.city

string

required

City of the payee.

params.postal_code

string

required

Postal code of the payee.

params.line1

string

required

Street address of the payee.

params.client_callback_url

string

required

Callback URL for payment confirmation response.

params.payment_method_type

enum<string>

required

Preferred payment method.

Available options:

mtn,

Orange,

Vodacom,

Airtel,

at,

Vodafone,

tnm,

Zamtel,

Halotel,

Tigo,

Free,

send money,

till number,

pay bill,

pesalink

params.customer_identifier

integer

Customer identifier for sub-wallet.

params.description

string

This is the description or message from payer who is paying out

params.third_party_reference_1

string

customer internal transaction reference

params.third_party_reference_2

string

customer external transaction reference

params.mtn

object[]

Using mtn method needs a recipient's phone number of payment method

params.Orange

object[]

Using Orange method needs a recipient's phone number of payment method

params.Vodacom

object[]

Using Vodacom method needs a recipient's phone number of payment method

params.Airtel

object[]

Using Airtel method needs a recipient's phone number of payment method

params.at

object[]

Using at method needs a recipient's phone number of payment method

params.Vodafone

object[]

Using Vodafone method needs a recipient's phone number of payment method

params.tnm

object[]

Using tnm method needs a recipient's phone number of payment method

params.Zamtel

object[]

Using Zamtel method needs a recipient's phone number of payment method

params.Halotel

object[]

Using Halotel method needs a recipient's phone number of payment method

params.Tigo

object[]

Using Tigo method needs a recipient's phone number of payment method

params.Free

object[]

Using Free method needs a recipient's phone number of payment method

params.sendmoney

object[]

Details for the send money payment method.

params.paybill

object[]

Details for the pay bill payment method.

params.tillnumber

object[]

Details for the till number payment method.

params.pesalink

object[]

Details for the pesalink payment method.

salt

string

required

Salt is used for security purposes. This is a random string and can be unique value for each request or always the same.

sender

string

required

The Sender is the title of the API Integration created through our app.

timestamp

integer

required

Timestamp of the request.

signature

string

required

Signature for verifying the request.

Response

200 - application/json

success

boolean

message

string

data

object

res

object

Get Payment Links Get Account Balance

Niobi Payments API

Authentication

Collections

Disbursements

Account Balance

Transaction Status

Submit Niobi Unified Payments

List of Supported Countries

List of supported pesalink banks

Body

Response

Niobi Payments API

Authentication

Collections

Disbursements

Account Balance

Transaction Status

​List of Supported Countries

​List of supported pesalink banks

Body

Response

List of Supported Countries

List of supported pesalink banks