# Payout

The Payouts API enables merchants to manage disbursements from their virtual pool to verified recipient bank accounts. This module provides the ability to query supported payout destinations, initiate payouts, and track the status of transactions in real time.<br>

Use this API to build seamless fund transfer experiences for your users, whether you’re paying out vendors, suppliers, or individual beneficiaries.

## Endpoints

<table><thead><tr><th width="236.34375">Name</th><th width="81.0625">Method</th><th>Endpoint</th></tr></thead><tbody><tr><td><a href="/pages/1lJi9UgViynwVFE63fQc">Get Payout Providers List</a></td><td><a href="/pages/1lJi9UgViynwVFE63fQc"><mark style="color:orange;">POST</mark></a></td><td><a href="/pages/1lJi9UgViynwVFE63fQc"><code>/api/v1/merchant/list-payout-providers</code></a></td></tr><tr><td><a href="/pages/BmR8X4pKRyoVFrI766an">Create Payout</a></td><td><a href="/pages/BmR8X4pKRyoVFrI766an"><mark style="color:orange;">POST</mark></a></td><td><a href="/pages/BmR8X4pKRyoVFrI766an"><code>/api/v1/merchant/payout</code></a></td></tr><tr><td><a href="/pages/qCPdmU4Eo9XabqQoV9HJ">Get Payout</a></td><td><a href="/pages/qCPdmU4Eo9XabqQoV9HJ"><mark style="color:green;">GET</mark></a></td><td><a href="/pages/qCPdmU4Eo9XabqQoV9HJ"><code>/api/v1/merchant/:invoice_no</code></a></td></tr></tbody></table>

## Integration Guide: Payout Workflow

### Step 1: Retrieve Available Payout Services

Before creating a payout, it’s highly recommended to confirm the validity of the recipient’s bank details. You can do this using our bank verification APIs, which help reduce the risk of failed or misdirected transfers.

{% content-ref url="/pages/1lJi9UgViynwVFE63fQc" %}
[Payout Provider](/api/payout-provider.md)
{% endcontent-ref %}

### Step 2: Initiate a Payout Transaction

Once you’ve confirmed the recipient details, proceed to initiate a payout request by providing necessary transaction information.

{% content-ref url="/pages/BmR8X4pKRyoVFrI766an" %}
[Create Payout](/api/payout/create-payout.md)
{% endcontent-ref %}

### Step 3: Monitor the Payout Progress

After submitting the payout, you can check the current status (e.g., pending, success, failed) using the `invoice_no` or `external_invoice_ref` provided.

{% content-ref url="/pages/qCPdmU4Eo9XabqQoV9HJ" %}
[Get Payout](/api/payout/get-payout.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payright.my/api/payout.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.