Introduction

Base url

        
  https://business.novasend.app/
      

Welcome to the Novasend Merchant API documentation.

Objectives

The Merchant API allows partners to integrate payment and transfer functionalities into their applications or internal systems.

Features

It provides the following capabilities:

• Initiate payments.
• Perform transfers.
• Receive real-time notifications.
• Refund a transaction.

Authentication

Novasend APIs use HTTP Basic authentication.
Each request must include an Authorization header containing your credentials encoded in Base64, in the format username:password.

For example:
Authorization: Basic <base64(username:password)>

A key (or credential pair) is provided by Novasend to identify your merchant account.
Never share these credentials. Do not expose them on the client side and store them only on secure servers.

• Creating an API Key

After logging into your dashboard, go to the Settings tab, then access the Token section and click the New Token button.

• Required Headers

  Authorization
  Required for authentication.
  Use Base64 encoding of your API credentials:
  Authorization: Basic <base64(username:password)>

  Content-Type
  Required for requests with a body.
  The value must be:
  Content-Type: application/json

  Accept-Language (optional)
  Allows you to set the language for error messages.
  Supported values: fr, en
  Example: Accept-Language: fr

• Error

  When an API request fails, the response includes error details in both the HTTP status code and the response body.

  Key	Description
  code	Error code identifier. There are multiple possible values. Example: (country_not_found).
  message	Contains the error description. Example: (The country with code C does not exist).
  statusCode	HTTP status code associated with the error (404).

Payment Options and Limits

Payin Amounts:

• min: 300 FCFA
• max: 2,000,000 FCFA

Payout Amounts:

• min: 500 FCFA;
• max: 1,500,000 FCFA

Côte d'Ivoire - CI

Cameroon - CM

Phone number format

• Côte d'ivoire -CI

• Caméroun -CM