> ## Documentation Index > Fetch the complete documentation index at: https://docs.niobi.co/llms.txt > Use this file to discover all available pages before exploring further. # Niobi Unified Payment > Niobi unified payment ## OpenAPI ````yaml post /api/niobi-payment openapi: 3.0.0 info: title: Niobi API description: >- REST API for collecting payments, sending payouts, and managing multi-currency wallets across Africa and global corridors. All requests require IP whitelisting and a unique per-request HMAC SHA-256 signature. version: 4.0.0 servers: - url: https://sandbox.users.niobi.co description: Sandbox, Development and Testing security: [] tags: - name: Niobi description: API Endpoints of Niobi paths: /api/niobi-payment: post: tags: - payment summary: Niobi Unified Payment description: Niobi Unified Payment operationId: NiobiPayment requestBody: description: >-

Supported Banks


NameCode
Kenya Commercial Bank01
Standard Chartered02
Absa Bank Kenya03
Ncba Bank Kenya07
Prime Bank10
Cooperative Bank11
National Bank of Kenya12
Citibank N.A Kenya16
Middle East Bank Kenya18
Bank of Africa Kenya19
Credit Bank Limited25
CFC Stanbic Kenya31
Paramount Bank50
Jamii Bora Bank51
Guaranty Trust Bank53
Guardian Bank55
I&M Bank 57
Diamond Trust Bank63
Sidian Bank66
Equity Bank Kenya68
Family Bank Limited70
Gulf African Bank72
First Community Bank74
Kenya Women's Finance Trust78


required: true content: application/json: schema: required: - amount - currency - payment_method_type - first_name - last_name - mobile - email - country - city - postal_code - line1 properties: amount: description: >- This is the Amount of money you wish to transfer. This amount shall always be less than the total value in your Balance type: integer format: amount example: 10 customer_identifier: description: This is the Customer Identifier number for sub-wallet. type: integer format: integer example: 1234 currency: description: >- This is the currency of the payouts you are making. At the moment, Niobi Payments supports KES transactions only type: string format: currency example: KES payment_reference: description: >- This is the account number associated with Niobi, that holds the value from which a pyaout is being made type: string format: payment_reference example: '123456789' first_name: description: This is the first name of the Payee who is being paid out type: string format: first_name example: John last_name: description: This is the last name of the Payee who is being paid out type: string format: last_name example: Doe mobile: description: >- This is the mobile number of the Payee who is being paid out. Use the correct formatting as described in the example type: string format: mobile example: '254647647649' email: description: This is the email of the Payee who is being paid out type: string format: email example: john@doe.com country: description: This is the country of the Payee who is being paid out type: string format: country example: KE city: description: This is the city of the Payee who is being paid out type: string format: city example: Nairobi postal_code: description: This is the postal code of the Payee who is being paid out type: string format: postal_code example: '001001' line1: description: >- This is the street address of the Payee who is being paid out type: string format: line1 example: abc, xyz description: description: >- This is the description or message from payer who is paying out type: string format: description example: abc, xyz client_callback_url: description: >- You can provide call back URL to get payment confirmation response. type: string format: client_callback_url example: https://your-domain.com/niobi/result payment_method_type: description: >- 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 type: string enum: - MTN - Orange - Vodacom - Airtel - AT - Vodafone - TNM - Zamtel - Halotel - Tigo - Free - send money - till number - pay bill - pesalink example: send money MTN: description: >- Using MTN method needs a recipient's phone number and correspondent of payment method and correspondent of payment method type: array items: required: - phone_number - correspondent properties: phone_number: description: >- Enter the recipient's mobile number. Be sure to use the right fomatting type: string format: phone_number example: '254647647649' correspondent: description: >- Enter the correspondent of respective country payment method. Be sure to use the right fomatting type: string format: correspondent example: MPESA_KEN type: object Orange: description: >- Using Orange method needs a recipient's phone number and correspondent of payment method type: array items: required: - phone_number - correspondent properties: phone_number: description: >- Enter the recipient's mobile number. Be sure to use the right fomatting type: string format: phone_number example: '254647647649' correspondent: description: >- Enter the correspondent of respective country payment method. Be sure to use the right fomatting type: string format: correspondent example: MPESA_KEN type: object Vodacom: description: >- Using Vodacom method needs a recipient's phone number and correspondent of payment method type: array items: required: - phone_number - correspondent properties: phone_number: description: >- Enter the recipient's mobile number. Be sure to use the right fomatting type: string format: phone_number example: '254647647649' correspondent: description: >- Enter the correspondent of respective country payment method. Be sure to use the right fomatting type: string format: correspondent example: MPESA_KEN type: object Airtel: description: >- Using Airtel method needs a recipient's phone number and correspondent of payment method type: array items: required: - phone_number - correspondent properties: phone_number: description: >- Enter the recipient's mobile number. Be sure to use the right fomatting type: string format: phone_number example: '254647647649' correspondent: description: >- Enter the correspondent of respective country payment method. Be sure to use the right fomatting type: string format: correspondent example: MPESA_KEN type: object AT: description: >- Using AT method needs a recipient's phone number and correspondent of payment method type: array items: required: - phone_number - correspondent properties: phone_number: description: >- Enter the recipient's mobile number. Be sure to use the right fomatting type: string format: phone_number example: '254647647649' correspondent: description: >- Enter the correspondent of respective country payment method. Be sure to use the right fomatting type: string format: correspondent example: MPESA_KEN type: object Vodafone: description: >- Using Vodafone method needs a recipient's phone number and correspondent of payment method type: array items: required: - phone_number - correspondent properties: phone_number: description: >- Enter the recipient's mobile number. Be sure to use the right fomatting type: string format: phone_number example: '254647647649' correspondent: description: >- Enter the correspondent of respective country payment method. Be sure to use the right fomatting type: string format: correspondent example: MPESA_KEN type: object TNM: description: >- Using TNM method needs a recipient's phone number and correspondent of payment method type: array items: required: - phone_number - correspondent properties: phone_number: description: >- Enter the recipient's mobile number. Be sure to use the right fomatting type: string format: phone_number example: '254647647649' correspondent: description: >- Enter the correspondent of respective country payment method. Be sure to use the right fomatting type: string format: correspondent example: MPESA_KEN type: object Zamtel: description: >- Using Zamtel method needs a recipient's phone number and correspondent of payment method type: array items: required: - phone_number - correspondent properties: phone_number: description: >- Enter the recipient's mobile number. Be sure to use the right fomatting type: string format: phone_number example: '254647647649' correspondent: description: >- Enter the correspondent of respective country payment method. Be sure to use the right fomatting type: string format: correspondent example: MPESA_KEN type: object Halotel: description: >- Using Halotel method needs a recipient's phone number and correspondent of payment method type: array items: required: - phone_number - correspondent properties: phone_number: description: >- Enter the recipient's mobile number. Be sure to use the right fomatting type: string format: phone_number example: '254647647649' correspondent: description: >- Enter the correspondent of respective country payment method. Be sure to use the right fomatting type: string format: correspondent example: MPESA_KEN type: object Tigo: description: >- Using Tigo method needs a recipient's phone number and correspondent of payment method type: array items: required: - phone_number - correspondent properties: phone_number: description: >- Enter the recipient's mobile number. Be sure to use the right fomatting type: string format: phone_number example: '254647647649' correspondent: description: >- Enter the correspondent of respective country payment method. Be sure to use the right fomatting type: string format: correspondent example: MPESA_KEN type: object Free: description: >- Using Free method needs a recipient's phone number and correspondent of payment method type: array items: required: - phone_number - correspondent properties: phone_number: description: >- Enter the recipient's mobile number. Be sure to use the right fomatting type: string format: phone_number example: '254647647649' correspondent: description: >- Enter the correspondent of respective country payment method. Be sure to use the right fomatting type: string format: correspondent example: MPESA_KEN type: object sendmoney: description: >- Using M-Pesa Send Money method needs a recipient's phone number type: array items: required: - phone_number properties: phone_number: description: >- Enter the recipient's mobile number. Be sure to use the right fomatting type: string format: phone_number example: '254647647649' type: object paybill: description: >- Using M-Pesa PayBill method needs A Paybill Number and Account Number type: array items: required: - paybill_number - account_number properties: paybill_number: description: paybill number type: string format: paybill_number example: '123456' account_number: description: Niobi account number type: string format: account_number example: '123456789' type: object tillnumber: description: >- Using M-Pesa till number method needs the recipient's Till Number type: array items: required: - till_number properties: till_number: description: Till number type: string format: till_number example: '123456' type: object pesalink: description: >- Niobi Payments also allows payouts via Bank Transfers using Pesalink. This transfer needs the following information type: array items: required: - bank_name - bank_code - branch_name - account_name properties: bank_name: description: your respective bank name type: string format: bank_name example: ABC bank_code: description: your respective bank code type: string format: bank_code example: '00' branch_name: description: your respective branch name type: string format: branch_name example: ABC account_name: description: your respective account name type: string format: account_name example: ABC account_number: description: >- This is the account number associated with the recipient that will receive the payout type: string format: account_number example: '123456789' type: object type: object responses: '200': description: Ok. content: application/json: schema: {} '201': description: Request Created. content: application/json: schema: {} '202': description: Request Accepted. content: application/json: schema: {} '400': description: Bad Request '401': description: Unauthorized '403': description: Forbidden '404': description: Resource Not Found '500': description: Internal Server Error '501': description: Not Implemented '503': description: Service Unavailable security: - apiAuth: [] components: securitySchemes: apiAuth: type: apiKey description: Enter token in format (Bearer ) name: Authorization in: header ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.