Get started

How payunit works

Payunit, electronic and mobile payment solution where dematerialized payment becomes simple.

Create your account

To be able to use the services of payunit you should have an active account on payunit. No account yet? create your account (opens in a new tab)

Create your first application

An application is the representation of a merchant's activity.

To be able to collect your payments, you will need to create an application.

Go to your dashboard by logging in here (opens in a new tab). No account created yet? create an account (opens in a new tab)

Go to the merchant dashboard, and then click on create application ( Applications > Create an application )

There are two types of applications

  • PAYMENT COLLECTION if you want to integrate payunit into your web or mobile application

  • PAYMENT LINKS to be able to create payment links and send them to your customers later

Activate your application

To Activate an application, go to the merchant dashboard, and display the list of your applications ( Applications > all applications ) then select the application you want, and then click on (Activate)

Test in sandbox environment

Before you start using payunit you will need to have an account and an active application.

Make an HTTP request to Payunit

There are many ways to make an HTTP request to the Payunit API. You can make a raw HTTP request in your code (for example, using a module like axios in NodeJS) or by using a tool like Postman. You may find it easier to use the Helper library or the Payunit SDK for your preferred programming language.

To make an HTTP request you should have the following:


Get the merchant Api user, merchant API key and merchant API password from the merchant dashboard under Settings > Security.

  • Application Key

There are two, for live and sandbox, to get access to this.
To get the keys of your application, go to the merchants dashboard, and display the list of your applications ( Applications > all applications ) then select the application you want, then click on the application details tab ( Application details )

Download the swagger documentation (opens in a new tab) to start testing payunit in sandbox.

Payunit environment variable

api_userkey token generated by payunit to create your account
api_passwordkey token generated by payunit to create your account
application_tokenYour application token, depending on the mode of your application use the sandbox key for sandbox operation and live for live operation
base_urlValue to use:
modeLive or test : the current mode of your application

Go live

Before going live we recommend checking the following points:

  • If your integration uses payunit notification to change the status of your payments in your system, make sure this route is whitelisted.
  • Make sure you have subscribed to at least one payment service provider (PSP).
  • Submit your KYC to gain access to more payment methods.
Last updated on March 27, 2023