Skip to main content
The Ndovu Partner API lets an integrated partner (bank, fintech, or other distribution partner) offer Ndovu investment products to its own customers. You build your own experience and call the API from your servers to list products and onboard your customers as Ndovu investors. This guide covers everything you need before writing any integration code:
  1. How you get credentials
  2. The base URL for your environment
  3. The calls every integration makes
The base URL below is the current development environment. Your onboarding email will confirm the production base URL to use before you go live.

​
How you get credentials

When your organization is onboarded as a partner, we create a partner record on our side and email your team:
  • Client ID — a public identifier for your organization
  • Client Secret — a private secret, shown to you only once in the onboarding email
Store the client secret the same way you’d store any API secret — in a secrets manager, never in source control or client-side code. If it’s lost, contact us to have it rotated; we cannot recover the original value since we only ever store a hash of it.

​
Base URL

All endpoints in this documentation are shown relative to this base URL, for example /api/v3/partners/auth.

​
The integration flow

Every partner integration follows the same flow:
1

Authenticate

Exchange your client ID and client secret for a short-lived access token. See Authentication.
2

Read your configuration

Check your country, currency, status and funding channels, and your identityPolicy, which decides what customer data you send. See Your Configuration.
3

Fetch your products

List the investment plans/funds available to your partner account. See Getting Products.
4

Onboard your customers

Create each customer as a Ndovu investor, under your own ID for them. See Onboarding a Customer.
5

Attach documents (optional)

Upload a customer’s identity documents as evidence of your KYC. See Uploading Documents.
6

Invest

Start an investment in a plan for a customer, by bank transfer or M-Pesa. See Investing for a Customer.
7

Show holdings and history

Read the customer’s portfolio, transactions and payments, and follow each investment to completion. See Portfolio and Transactions and Checking Status.
Every endpoint is also listed, with a playground, under API Reference. When you’re ready for production, see Going Live.

​
Support

If anything in this documentation doesn’t match what you see, or your credentials aren’t working, email support@ndovu.co.