Make Payments
Niobi Unified Payment v2
Make Payments
Niobi Unified Payment v2
Handles payment processing for Niobi, supporting multiple payment methods.
POST
/
api
/
v2
/
niobi-payment
curl --request POST \
--url https://dev.users.niobi.co/api/v2/niobi-payment \
--header 'Content-Type: application/json' \
--data '{
"client_id": "K1PoY1WYricSpXh6Wm24twnk6ecPJOWrHGsqiKJr",
"params": {
"amount": 1000,
"customer_identifier": 1234,
"currency": "KES",
"payment_reference": "TRANS-123456789",
"first_name": "John",
"last_name": "Doe",
"mobile": "254123456789",
"email": "john@doe.com",
"country": "KE",
"city": "Nairobi",
"postal_code": "001001",
"line1": "abc, xyz",
"description": "abc, xyz",
"client_callback_url": "https://your-domain.com/niobi/result",
"payment_method_type": "send money",
"MTN": [
{
"phone_number": "254123456789"
}
],
"Orange": [
{
"phone_number": "254123456789"
}
],
"Vodacom": [
{
"phone_number": "254123456789"
}
],
"Airtel": [
{
"phone_number": "254123456789"
}
],
"AT": [
{
"phone_number": "254123456789"
}
],
"Vodafone": [
{
"phone_number": "254123456789"
}
],
"TNM": [
{
"phone_number": "254123456789"
}
],
"Zamtel": [
{
"phone_number": "254123456789"
}
],
"Halotel": [
{
"phone_number": "254123456789"
}
],
"Tigo": [
{
"phone_number": "254123456789"
}
],
"Free": [
{
"phone_number": "254123456789"
}
],
"sendmoney": [
{
"phone_number": "254123456789"
}
],
"paybill": [
{
"paybill_number": "123456",
"account_number": "123456789"
}
],
"tillnumber": [
{
"till_number": "123456"
}
],
"pesalink": [
{
"bank_name": "ABC",
"bank_code": "00",
"branch_name": "ABC",
"account_name": "ABC",
"account_number": "123456789"
}
]
},
"salt": "waqassharif00494",
"sender": "ApexVim",
"timestamp": 1709363033,
"signature": "2193d01d50d4bd5da234ac0e0add5d4ccb40907a1b1ab27a12d2c1d88a5d5807"
}'
Body
application/json
Payload required for initiating a Niobi payment transaction.
The body is of type object
.
Response
200
Ok.
curl --request POST \
--url https://dev.users.niobi.co/api/v2/niobi-payment \
--header 'Content-Type: application/json' \
--data '{
"client_id": "K1PoY1WYricSpXh6Wm24twnk6ecPJOWrHGsqiKJr",
"params": {
"amount": 1000,
"customer_identifier": 1234,
"currency": "KES",
"payment_reference": "TRANS-123456789",
"first_name": "John",
"last_name": "Doe",
"mobile": "254123456789",
"email": "john@doe.com",
"country": "KE",
"city": "Nairobi",
"postal_code": "001001",
"line1": "abc, xyz",
"description": "abc, xyz",
"client_callback_url": "https://your-domain.com/niobi/result",
"payment_method_type": "send money",
"MTN": [
{
"phone_number": "254123456789"
}
],
"Orange": [
{
"phone_number": "254123456789"
}
],
"Vodacom": [
{
"phone_number": "254123456789"
}
],
"Airtel": [
{
"phone_number": "254123456789"
}
],
"AT": [
{
"phone_number": "254123456789"
}
],
"Vodafone": [
{
"phone_number": "254123456789"
}
],
"TNM": [
{
"phone_number": "254123456789"
}
],
"Zamtel": [
{
"phone_number": "254123456789"
}
],
"Halotel": [
{
"phone_number": "254123456789"
}
],
"Tigo": [
{
"phone_number": "254123456789"
}
],
"Free": [
{
"phone_number": "254123456789"
}
],
"sendmoney": [
{
"phone_number": "254123456789"
}
],
"paybill": [
{
"paybill_number": "123456",
"account_number": "123456789"
}
],
"tillnumber": [
{
"till_number": "123456"
}
],
"pesalink": [
{
"bank_name": "ABC",
"bank_code": "00",
"branch_name": "ABC",
"account_name": "ABC",
"account_number": "123456789"
}
]
},
"salt": "waqassharif00494",
"sender": "ApexVim",
"timestamp": 1709363033,
"signature": "2193d01d50d4bd5da234ac0e0add5d4ccb40907a1b1ab27a12d2c1d88a5d5807"
}'