Release Date: [02/07/2025]

​
Overview

This release includes important API updates and improvements, including enhanced payment link functionality, OTP verification for Ivory Coast Orange deposits, revised transaction limits, updated country support, and a new best practices guide.

​
New Features and API Improvements

  • Prefilled Customer Data - you can now generate payment links with prefilled customer data. By passing fields such as first_name, last_name, email, and mobile, the user is directed straight to the checkout page with their details already filled in.

Previously: Payment links required customers to manually enter their information at checkout.

Sample V2 Payment link creation API with no customer data:

{
  "client_id": "K1PoY1WYricSpXh6Wm24twnk6ecPJOWrHGsqiKJr",
  "salt": "justrandomstring",
  "sender": "John.co",
  "timestamp": 1709363033,
  "signature": "2193d01d50d4bd5da234ac0e0add5d4ccb40907a1b1ab27a12d2c1d88a5d5807",
  "params": {
    "business_name": "my business",
    "item_name": "item name",
    "callback_url": "https://webhook.site/unique-id",
    "redirection_url": "https://webhook.site/unique-id",
    "amount": "5000",
    "logo": "This is brand logo. Use the base64 format to upload a file of maximum 2MB size.",
    "country_id": "This is integer value. You can get country id from supported country table attached here.",
    "currency": "KES"
}

Image

Now: Backward compatibility with v2. You can pass in the customer data. Sample V3 API Payment link with customer data:

{
  "client_id": "K1PoY1WYricSpXh6Wm24twnk6ecPJOWrHGsqiKJr",
  "salt": "justrandomstring",
  "sender": "John.co",
  "timestamp": 1709363033,
  "signature": "2193d01d50d4bd5da234ac0e0add5d4ccb40907a1b1ab27a12d2c1d88a5d5807",
  "params": {
    "business_name": "my business",
    "item_name": "item name",
    "callback_url": "https://webhook.site/unique-id",
    "redirection_url": "https://webhook.site/unique-id",
    "amount": "5000",
    "logo": "This is brand logo. Use the base64 format to upload a file of maximum 2MB size.",
    "country_id": "This is integer value. You can get country id from supported country table attached here.",
    "currency": "KES",
    "first_name": "First name",
    "last_name": "Last name",
    "email":"john.dpe@example.com",
    "mobile": "2547123xxxx7"
}

You can find more details here Checkout Page

​
Orange OTP for Ivory Coast Deposits

  • For Orange payins in Ivory Coast, OTP verification is now required.
  • Ensure your implementation includes this OTP step. Include the field below within the deposit request:
    • otp
    {
      "client_id": "client_id",
      "params": {
          "amount": "500",
          "callback_url": "https://webhook.site/",
          "country_id": 3,
          "currency": "XOF",
          "mobile": "2347xxxxxx00",
          "name": "Joseph Mike",
          "otp": "1234",
          "payment_method_type": "Orange",
          "third_party_reference_1": null,
          "third_party_reference_2": null
      },
      "salt": "salt value",
      "sender": "Integration name",
      "timestamp": xxxxxxx,
      "signature": "1xxxxxxxxxxxxxxxx8"
  }
  • Verify the transaction using our verification API: /v4/niobi-unified-process-transaction
    "client_id": "TLNnEXPhsFmBUbU6vwVPVAVZCLVUC7OL2Bu5HnQo",
    "params": {
        "otp": "1234",
        "payment_token": "7cb952a7-6477-4ff0-8736-3dd9488b6aa3"
    },
    "salt": "niobi_salt",
    "sender": "ApexVim",
    "timestamp": 1744788807,
    "signature": "3a3cf7f2e3ff8d4ee991d7e1323312887dfda8536b8c2e197d0d4ef764013658"
}

Find the full reference under collection methods.

​
Updated Transaction Limits

  • We have updated our transaction limits for some payment methods. Please refer to the full list of transaction limits here: transaction limits.

​
Updated Supported Countries

  • Discontinued Rwanda temporarily. Please find the full list of supported countries here

​
Added Best Practices Guide

  • A new guide is available to help you integrate more effectively. Find more details here