POST
/
api
/
niobi-payment
curl --request POST \
  --url https://dev.users.niobi.co/api/niobi-payment \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 10,
  "customer_identifier": 1234,
  "currency": "KES",
  "payment_reference": "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",
      "correspondent": "MPESA_KEN"
    }
  ],
  "Orange": [
    {
      "phone_number": "254123456789",
      "correspondent": "MPESA_KEN"
    }
  ],
  "Vodacom": [
    {
      "phone_number": "254123456789",
      "correspondent": "MPESA_KEN"
    }
  ],
  "Airtel": [
    {
      "phone_number": "254123456789",
      "correspondent": "MPESA_KEN"
    }
  ],
  "AT": [
    {
      "phone_number": "254123456789",
      "correspondent": "MPESA_KEN"
    }
  ],
  "Vodafone": [
    {
      "phone_number": "254123456789",
      "correspondent": "MPESA_KEN"
    }
  ],
  "TNM": [
    {
      "phone_number": "254123456789",
      "correspondent": "MPESA_KEN"
    }
  ],
  "Zamtel": [
    {
      "phone_number": "254123456789",
      "correspondent": "MPESA_KEN"
    }
  ],
  "Halotel": [
    {
      "phone_number": "254123456789",
      "correspondent": "MPESA_KEN"
    }
  ],
  "Tigo": [
    {
      "phone_number": "254123456789",
      "correspondent": "MPESA_KEN"
    }
  ],
  "Free": [
    {
      "phone_number": "254123456789",
      "correspondent": "MPESA_KEN"
    }
  ],
  "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"
    }
  ]
}'
"<any>"

Authorizations

Authorization
string
header
required

Enter token in format (Bearer <token>)

Body

application/json
<h2>Supported Banks</h2><br><table><thead><th>Name</th><th>Code</th></thead><tbody><tr><td>Kenya Commercial Bank</td><td>01</td></tr><tr><td>Standard Chartered</td><td>02</td></tr><tr><td>Absa Bank Kenya</td><td>03</td></tr><tr><td>Ncba Bank Kenya</td><td>07</td></tr><tr><td>Prime Bank</td><td>10</td></tr><tr><td>Cooperative Bank</td><td>11</td></tr><tr><td>National Bank of Kenya</td><td>12</td></tr><tr><td>Citibank N.A Kenya</td><td>16</td></tr><tr><td>Middle East Bank Kenya</td><td>18</td></tr><tr><td>Bank of Africa Kenya</td><td>19</td></tr><tr><td>Credit Bank Limited</td><td>25</td></tr><tr><td>CFC Stanbic Kenya</td><td>31</td></tr><tr><td>Paramount Bank</td><td>50</td></tr><tr><td>Jamii Bora Bank</td><td>51</td></tr><tr><td>Guaranty Trust Bank</td><td>53</td></tr><tr><td>Guardian Bank</td><td>55</td></tr><tr><td>I&M Bank </td><td>57</td></tr><tr><td>Diamond Trust Bank</td><td>63</td></tr><tr><td>Sidian Bank</td><td>66</td></tr><tr><td>Equity Bank Kenya</td><td>68</td></tr><tr><td>Family Bank Limited</td><td>70</td></tr><tr><td>Gulf African Bank</td><td>72</td></tr><tr><td>First Community Bank</td><td>74</td></tr><tr><td>Kenya Women's Finance Trust</td><td>78</td></tr></tbody></table><br><br>

The body is of type object.

Response

200
application/json

Ok.

The response is of type any.