> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monieswitch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Automating Bulk Payouts to Vendors or Employees

> A guide to sending mass payouts efficiently using the Monieswitch API or dashboard.

### Who is this for?

<Note>
  Businesses and developers who need to pay multiple recipients (vendors,
  employees, partners) at once using Monieswitch.
</Note>

## Overview

This guide covers:

* Preparing your bulk payout data
* Sending bulk payouts via the API
* Tracking payout status
* Best practices for automation and security

***

## Prerequisites

<Steps>
  <Step title="Create Monieswitch Account">
    **A Monieswitch account**. Register at [Monieswitch
    Dashboard](https://dashboard.monieswitch.com/register).
  </Step>

  <Step title="Get API Key">
    **API Key** from your Monieswitch dashboard.
  </Step>

  <Step title="Set Up Backend Server">
    **A backend server** or script to automate payouts.
  </Step>
</Steps>

***

## 1. Prepare Your Bulk Payout Data

Create a list of recipients and amounts. Example in JSON:

```json theme={"system"}
[
  {
    "accountNumber": "0123456789",
    "bankCode": "044",
    "amount": 5000,
    "narration": "Vendor payment"
  },
  {
    "accountNumber": "0987654321",
    "bankCode": "058",
    "amount": 7000,
    "narration": "Employee salary"
  }
]
```

***

## 2. Send Bulk Payouts via API

Send a POST request to the bulk payout endpoint:

```json theme={"system"}
POST https://nini.monieswitch.com/api/payouts/bulk
Headers:
  Authorization: Bearer YOUR_API_KEY
  Content-Type: application/json

Body:
{
  "payouts": [
    {
      "accountNumber": "0123456789",
      "bankCode": "044",
      "amount": 5000,
      "narration": "Vendor payment"
    },
    {
      "accountNumber": "0987654321",
      "bankCode": "058",
      "amount": 7000,
      "narration": "Employee salary"
    }
  ]
}
```

***

## 3. Track Payout Status

* **Check status via API:**
  `GET /api/payouts/bulk/{batchId}`

* **Receive webhook notifications:**
  Set up webhooks to get real-time updates on payout status.

***

## 4. Best Practices

* Validate all recipient account details before sending payouts.
* Use unique batch references for each payout run.
* Secure your API keys and never expose them in client-side code.
* Reconcile payouts using webhook notifications and API status checks.

***

<Callout type="success" title="Need Help?">
  Visit our [Support](/help/support) page or join the [Monieswitch
  Community](https://slack.com) for assistance.
</Callout>