terminal

KoboPoint API Reference

Integrate seamless payment solutions into your applications with our robust and secure API infrastructure. Powering the next generation of African fintech.

lock_person

Developer Access Required

Developer access is available on request. Please contact our partnerships team to obtain your API keys and sandbox environment credentials.

Introduction

The KoboPoint API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

You can use the KoboPoint API in test mode, which does not affect your live data or interact with the banking networks. The API key you use to authenticate the request determines whether the request is live mode or test mode.

Base URL

https://api.kobopoint.com/v1

Authentication

The KoboPoint API uses API keys to authenticate requests. You can view and manage your API keys in the KoboPoint Dashboard.

Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.

Authentication to the API is performed via HTTP Basic Auth. Provide your API key as the basic auth username value. You do not need to provide a password.

BASH

curl https://api.kobopoint.com/v1/charges \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d amount=2000 \
  -d currency=ngn

Wallet APIs

Programmatically create and manage wallets for your users. Wallets allow users to store value, receive transfers, and fund offline transactions.

POST

/wallets/create

Creates a new wallet for a user. The user must be KYC verified before a wallet can be active.

Parameter	Type	Description
user_id	string	Unique identifier for the user.
currency	string	3-letter ISO currency code (e.g. NGN).
label	string	Optional friendly name for the wallet.

RESPONSE (JSON)

{
  "status": "success",
  "data": {
    "wallet_id": "wlt_123456789",
    "account_number": "0123456789",
    "bank_name": "KoboPoint MFB",
    "balance": 0,
    "currency": "NGN",
    "created_at": "2023-10-27T10:00:00Z"
  }
}

Offline Transactions

Our flagship feature allows transactions without internet connectivity via USSD or offline QR codes.

dialpad

USSD Initiation

Generate USSD strings for users to dial and complete payments on feature phones.

View USSD Docs →

qr_code_2

Offline QR

Generate static or dynamic QR codes that contain encrypted transaction data.

View QR Docs →

Webhooks

Listen for events on your KoboPoint account so your integration can automatically trigger reactions.

Event Types

charge.success

Occurs whenever a charge is successful.

transfer.failed

Occurs whenever a transfer fails.

wallet.funded

Occurs when funds are added to a wallet.

Questions?

We're here to help you integrate KoboPoint into your product.