Offline Disbursement (Cash withdrawal using "Pay Code")

Table of Contents

Offline disbursement can now be done through the use of a paycode generated by merchants on the monnify platform.

A Paycode is the short form for payment code and it’s a 10 digit number a customer can take to a Moniepoint Agent to withdraw cash.

Merchants generate this paycode and provide it to customers who then take this paycode to any Moniepoint agent close by. Once the paycode is shown to the agent, the paycode is verified and the amount tied to the paycode is given to the customer in cash while the merchant account is debited of the amount.

Cash Disbursement Flow


Paycode Generation

Merchants can generate paycode for their customers from their dashboard by using the create new paycode button.

Upon clicking the create new paycode button, you are redirected to a page to provide details that should be linked with the paycode which is what the Moniepoint agent will use to verify the transaction before releasing funds to the your customers. Details to be provided includes beneficiary name (name of customer for funds to be disbursed to), amount to be disbursed, reference, and also expiry date (If expiry date for paycode is not defined, it will expire by default after 24 hours).

A paycode remains active until the time allocated to it expires or when it is cancelled by merchant

View list of Paycodes and Status

As a merchant, you can have an overview of all paycodes generated over a period of time together with their status.


Paycodes can have the following status:

  1. PENDING - Ready to be used but not used.

  2. SUCCESS - Has been utilized successfully.

  3. EXPIRED - Has been automatically expired having exhausted the configured lifespan.

  4. CANCELLED - Was canceled by the user.

Testing Your Integration

Before doing any test, ensure you are on test mode.

Paycode Testing

Monnify also allows you to simulate the use of paycodes for offline disbursement. Here are the steps to testing.

Step 1 - Create a paycode

Step 2 - Once created, you can then view all created paycodes and select the one you want to test

Step 3 - Once you have selected the paycode you want to view, all the details about it will be displayed.

Step 4 - You’d notice that the full paycode is not displayed to you for security reasons, but once you click on the view icon, you’d be asked to put in your password. Once your password is correctly inputed, you get to see the paycode.

Locked paycode
Input password to view paycode
View full paycode

Step 5 - You go back to the simulator page to input the paycode for the test.

Step 6 - Paycode is verified and details are displayed to you.

Step 7 - Paycode is then debited of the amount specified.



For offline disbursements done using paycodes, a flat fee of N 100 will be charged.