Other Monnify Services

1. Dashboard Transfers (Single & Bulk): Move money from your dashboard. This payout channel is ideal for paying one-off invoices, or uploading a single spreadsheet to process payroll for multiple employees at once.
2. Bank Transfers via API: Ideal for teams that want full automation. Integrate the Monnify Disbursement APIs to programmatically send funds from your Monnify wallet into any bank account.
3. Offline Payouts via Paycodes: Generate a unique 10-digit paycode that your customer can take to any Moniepoint Agent to withdraw cash.

Note for Engineering Teams: This feature can be used via the Monnify dashboard or API. This guide covers the dashboard setup. To integrate this feature using the API, see the Disbursement API Documentation.

Step 1: Request Feature Access

Payouts involve moving funds out of your account, so the feature requires a one-time activation. To request access, send an email from the email address linked to your Monnify account.

1. Send to: [email protected]
2. Subject: Need to Set up Payouts: [Your Business Name]
3. Body: Provide your Monnify Business Code, and a brief description of your intended use (e.g., paying vendors, staff salaries)

Tip: You can find your Business Code at the top of your dashboard menu.

Our team typically reviews and activates requests within 24 hours. You'll receive a confirmation email within the same email thread once the feature is enabled.

Step 2: Initiate a Payout

Once activated, follow these steps to make a payout:

1. Log in to your Monnify Dashboard and click Transfers from the left-hand menu
2. Click Make a Transfer in the top right corner.

3. Choose your transfer type:

1. Single Upload: For one-off payments to single or multiple accounts. Enter the required details: destination bank, account number, amount, and narration. Then click Add. You can save the account as a beneficiary for faster future payments later.
2. Bulk Upload: For payroll or multi-vendor payments. Upload an Excel sheet with all account details and amounts. A template is available to download directly on that page.

4. Once your transfers are added, they will appear in a list in the other column. Review the details and click Transfer.

5. The system will prompt you to enter an OTP for security verification. Enter the OTP to authorize the payout.

Need to delegate this task? If you want your team to handle payouts without risking unauthorised transfers, see our guide on Setting Up Team Permissions for Payouts.

1. Log in to your Monnify dashboard and select Settings from the left-hand menu.
2. Select the Team tab on the top navigation bar.
3. Click Manage Roles. The next page shows the Default Roles and the Custom Roles sections.

1. To create the Initiator Role, click Create Custom Role.
2. Give it a name (e.g., Payout Initiator) and brief description
3. In the list below, scroll to the Disbursements section and check the “Initiate single transfer” box
4. Select any other permissions this team member needs, then click Create Role
5. To create the Approver Role, click Create Custom Role again.
6. Name it (e.g., Payout Approver) and add a brief description
7. In the list below, scroll to the Others section and check the box for “User can approve request”
8. Add any other necessary permissions for this manager, then click Create Role

Note: Once both roles are created, assign them to the respective team members from the Team tab.

Managing the Approval Workflow

Once you have team roles set up, every payout that requires approval follows a clean two-step process:

1. My Requests (Initiator): After submitting a payout, the initiator can track its approval status under the My Requests tab on the dashboard menu. Funds do not move until the approver acts.
2. Pending Approvals (Approver): The approver navigates to Pending Approvals on the dashboard menu, reviews the amount and destination account, then approves or rejects the request.

Note for Engineering Teams: This feature can be created using the Monnify dashboard or API. This guide covers the dashboard setup. To integrate this feature using the API, see Paycode Generation using APIs.

Step 1: Request Feature Access

To get started, request access from our integration team using the email address linked to your Monnify account.

1. Send to: [email protected]
2. Subject: Need to Set up Paycode: [Your Business Name]
3. Body: Provide your Monnify Business Code and a brief description of how you plan to use the feature.

Tip: You can find your Business Code at the top of your dashboard menu.

Our team typically reviews and activates requests within 24 hours. You'll receive a confirmation email within the same email thread once the feature is enabled.

Step 2: Generate a Paycode (Dashboard)

Once access is confirmed:

1. Log in to your Monnify Dashboard and click Paycodes from the left-hand menu
2. Click Create New Paycode on the right.

3. Choose your paycode type:

1. Single Paycode: Ideal for one-off payments to one or more recipients. Fill in the required details, then click Create Paycode.
2. 
   
3. The required details:
4. Beneficiary Name: Name of the cash recipient
5. Amount: The exact amount to be disbursed.
6. Reference: Your unique internal tracking number for this payout.
7. Expiry Date: You can set a date for the code to expire. If left blank, the code expires after 24 hours

5. Click Create Paycode.

6. Enter the OTP when prompted. Your paycode will be generated and ready to share.

Understanding Paycode Statuses

Track every code's lifecycle directly from your dashboard. A Paycode will always display one of these four statuses:

Developer Note: Each of these services requires integrating the corresponding API endpoint. See the Verification API Documentation to get started.

1. Add a step in your signup process asking the customer to input their BVN or NIN.
2. Verify the provided BVN or NIN using a verification service (such as Monnify's Verification APIs) before proceeding.
3. Once verified, create the account by sending an account creation request to the Monnify API. Ensure you include the captured BVN and/or NIN in the request.
4. After verifying the information, Monnify will generate the applicable virtual account for you to display to the user.

Workflow 2: Updating Details for EXISTING Customers

If you have existing customers who generated virtual accounts before this mandate, you have to update their profiles:

1. Implement a notification bar or pop-up on your app or website prompting the user to update their KYC Information.
2. Ask them to input their BVN and/or NIN, and verify the details using a verification service, such as Monnify's Verification APIs.
3. Send a request to Monnify for account details update.
4. Monnify will update the customer's profile. Once you get a successful response from Monnify, display a success message so the customer knows their account is secure.

Note: For the exact endpoints, parameters, and payloads required for this feature, see the Monnify BVN/NIN Verification Documentation.

Applicable Fees

1. Linking is FREE: Monnify does not charge you any fees for creating reserved accounts or updating existing accounts with a BVN or NIN.
2. Verification Costs: However, if you choose to use Monnify's API to verify the BVN or NIN before linking it, standard API verification fees will apply (e.g., ₦10 for every successful BVN Match, ₦60 for every successful NIN verification). If you use a different verification service, it may attract fees but these are not charged by Monnify.

Important Note: Bills Payment is currently available via API integration only. See the Bills Payment Developer Documentation for the required endpoints and payloads.

Want to turn your platform into a one-stop shop? The Monnify Bills Payment feature allows you to seamlessly sell essential day-to-day services directly from your app or website.

Rather than managing individual contracts with dozens of different service providers (like MTN, DSTV, or IKEDC), Monnify acts as your single aggregator. You can process these bills using the exact Monnify account and wallet you already use for collections and payouts.

Services You Can Sell

Once activated, you can offer a wide range of bill payment options to your users, including:

1. Electricity: Prepaid and Postpaid meters
2. Cable TV: DSTV, GOTV, StarTimes, etc.
3. Airtime & Data Bundles
4. Education: E.g., WAEC or JAMB pins

How You Make Money: The Settlement & Commission Process

Monnify operates on a Commission (or Cashback) model. You earn a commission for every successful bill you sell.

To make reconciliation perfectly clear on your dashboard, we process your settlement instantly through a two-step "Debit and Credit" movement:

1. Gross Debit: First, your Monnify wallet is debited for the full cost of the bill (the "Vend Amount" + any applicable merchant fees).
2. Commission Credit : Immediately after, your wallet is credited with your earned commission. This represents your instant profit.

Note: Commission rates vary depending on the specific service provider and product

Example:

Imagine your customer buys a ₦5,000 data bundle, and your commission on that product is ₦500.

1. Step 1: Your Monnify wallet is debited ₦5,000.
2. Step 2: Your Monnify wallet is instantly credited ₦500.
3. Result: The final net cost to your business is exactly ₦4,500, while your customer gets their ₦5,000 data.

Terms to Note In the Bills Payment Service

1. Vend Amount: The base amount of the transaction. This is the exact, gross value of the service the customer is buying.
2. Merchant Fee: A fee charged by the aggregator to the merchant. This is only applicable to certain products; otherwise, it is set to zero.
3. Merchant Payable Amount: The total amount deducted from your wallet to process the service (Vend Amount + Merchant Fee).
4. Biller (Service Provider): The actual company providing the utility to the customer, such as MTN, DSTV, or Ikeja Electric.

Important Note: Bills Payment is currently available via API integration only. See the Bills Payment Developer Documentation for the required endpoints and payloads.

Before integrating the bills payment feature into your app or website, you need to get the feature activated on your account. You also need to understand the architectural workflow required to keep your transactions secure.

How to Activate Bills Payment

From the email address linked to your Monnify account, send an email:

1. Send to: [email protected]
2. Subject: Bills Payment Activation: [Your Business Name]
3. Body: Provide your Monnify Business Code and a brief description of the services you intend to sell.

Tip: You can find your Business Code at the top of your dashboard menu.

Our team typically reviews and activates requests within 24 hours. You'll receive a confirmation email within the same email thread once the feature is enabled, and you can begin implementing the API endpoints.

The 3 Integration Phases

When building a bill payment feature into your app, the user experience is critical. If a customer accidentally sends money to the wrong meter number, it creates a massive support headache.

To protect you and your customers, the Monnify Bills Payment architecture requires your system to follow three primary phases: Discovery, Validation, and Vending.

Phase 1: Discovery (Finding the Right Service)

Before a customer can pay, your app must show them what is available. Your engineers will use our APIs to pull lists in this exact order:

1. Categories: Show the user general bill types (e.g., Electricity).
2. Billers: Show the providers or billers under that category (e.g., Ikeja Electric).
3. Products: Show the specific packages offered by that biller (e.g., Prepaid Meter Top-up).

Phase 2: Validation (The Safety Check)

This is an incredibly important step. Before you process a payment, you need to validate the customer’s details.

1. How it works: The customer types in their unique identifier (like a phone number or meter number). Your system pings Monnify to verify it.
2. The Result: If the details are valid, Monnify returns the registered name on that account (e.g., "John Doe") and a unique Validation Reference.
3. Why it matters: Showing the validated name to the customer allows them to confirm there is no mistake. If validation fails, your app should display an appropriate error and halt the payment process.

Phase 3: Vending (Processing the Payment)

Once the customer's details are validated, you can initiate the final payment. Your system sends key details such as the amount and customer ID to Monnify, we process the payment and return a response to you.