POST
/
api
/
niobi-payment

Authorizations

Authorization
string
headerrequired

Enter token in format (Bearer <token>)

Body

application/json
amount
integer
required

This is the Amount of money you wish to transfer. This amount shall always be less than the total value in your Balance

currency
string
required

This is the currency of the payouts you are making. At the moment, Niobi Payments supports KES transactions only

first_name
string
required

This is the first name of the Payee who is being paid out

last_name
string
required

This is the last name of the Payee who is being paid out

mobile
string
required

This is the mobile number of the Payee who is being paid out. Use the correct formatting as described in the example

email
string
required

This is the email of the Payee who is being paid out

country
string
required

This is the country of the Payee who is being paid out

city
string
required

This is the city of the Payee who is being paid out

postal_code
string
required

This is the postal code of the Payee who is being paid out

line1
string
required

This is the street address of the Payee who is being paid out

payment_method_type
enum<string>
required

This is the preferred payment method you want to use to payout the money and what makes the Niobi Payment API really unique as we support all popular mobile money and bank payments

Available options:
mtn,
Orange,
Vodacom,
Airtel,
at,
Vodafone,
tnm,
Zamtel,
Halotel,
Tigo,
Free,
send money,
till number,
pay bill,
pesalink
customer_identifier
integer

This is the Customer Identifier number for sub-wallet.

payment_reference
string

This is the account number associated with Niobi, that holds the value from which a pyaout is being made

description
string

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

client_callback_url
string

You can provide call back URL to get payment confirmation response.

mtn
object[]

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

Orange
object[]

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

Vodacom
object[]

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

Airtel
object[]

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

at
object[]

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

Vodafone
object[]

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

tnm
object[]

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

Zamtel
object[]

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

Halotel
object[]

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

Tigo
object[]

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

Free
object[]

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

sendmoney
object[]

Using M-Pesa Send Money method needs a recipient's phone number

paybill
object[]

Using M-Pesa PayBill method needs A Paybill Number and Account Number

tillnumber
object[]

Using M-Pesa till number method needs the recipient's Till Number

Niobi Payments also allows payouts via Bank Transfers using Pesalink. This transfer needs the following information

Response

200 - application/json

The response is of type any.