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

# Disbursement

> Disburse funds from your SoleasPay account to yours customers

## Disbursement (PayOut)

You can disburse funds from your **SoleasPay account** to a **customer’s mobile money wallet**.

✅ This operation **does not require customer PIN authorization** and is usually processed within **seconds**.

***

## 🔁 Payout Flow

1. You submit a **payout request** to SoleasPay.
2. SoleasPay forwards the request to the **Mobile Money Operator (MMO)**.
3. The MMO processes the transaction and informs SoleasPay.
4. SoleasPay notifies your backend via:
   * A **callback URL** (if configured), or
   * You can **manually check** the payout status using the `Check Payout Status` endpoint.

***

## 🔔 Callback Notification

If you’ve configured a **callback URL**, SoleasPay will notify you of the final transaction status using a **Payout Status Callback**.

> If not, use the **Check Payout Status endpoint** to poll the status.

***

## 📌 Payout Status Lifecycle

After your payout request is submitted, it may transition through the following statuses:

| Status       | Description                                                       |
| ------------ | ----------------------------------------------------------------- |
| `PROCESSING` | The payout request has been accepted by SoleasPay for processing. |
| `SUCCESS`    | The payout was successful. ✅ **Final State**                      |
| `FAILLURE`   | The payout failed. ❌ **Final State**                              |

***

<img src="https://mintcdn.com/mysoleas/RWWnWDsD1uZt587m/images/payout.png?fit=max&auto=format&n=RWWnWDsD1uZt587m&q=85&s=f1c84a498eae1951292e0d177889b0d2" alt="Deposit Status Flow" style={{ marginTop: '1rem', maxWidth: '100%' }} width="1536" height="1024" data-path="images/payout.png" />

***

## 📦 Enqueued Payouts

When an **MMO is temporarily unavailable or experiencing issues**, payouts may not be processed immediately.

In these cases:

* The payout is still **accepted by SoleasPay**, but marked as `PROCESSING`.
* The request is **automatically processed later** when the MMO is back online.

### 🛑 Cancelling Enqueued Payouts

You can cancel an enqueued payout if it hasn't yet been submitted:

* Use the `Cancel Enqueued Payout` API endpoint.
* Or cancel directly from the **SoleasPay Dashboard**.

***

## 📡 MMO Availability

Our Payment Operations team monitors MMO availability **24/7**. You can:

* View the **real-time status** on the [SoleasPay Status Page](https://soleaspay.com)
* Access MMO stability programmatically via the **Availability Endpoint**

> Use this to avoid initiating payouts during MMO downtime.

***

## ⚙️ Implementation Tip

Ensure your integration:

* Handles all **status transitions** appropriately.
* Supports **callback or polling** to track payout status.
* Implements retry or cancellation logic for `ENQUEUED` payouts.

For more details visite  [payout api-reference](https://doc.soleaspay.com/api-reference/endpoint/disbursement).