# Payout requests 

This topic describes how to view and allocate customer requested payouts. Customers can make requests for payout amounts that they want to receive. Users, or members, of your organization manage these requests by assigning funds to be paid out to specified payment instruments.

All payout request are added to the **Payout requests** segment which is located in the **Payments** data table. This segment has no filters and will show all payout requests. To apply filters, see [Filter payout requests](#filter-payout-requests).

## Payout request process

This procedure describes a typical payout request process.

1. A payout request form URL is generated on the customers behalf and is shared with the customer — see [Request a payout](#request-a-payout).
2. The customer [provides a payment instrument for the payout request](#provide-a-payment-instrument-for-a-payout-request).
3. The payout request is processed and funds are allocated to the related payment instrument — see [Allocate funds](#allocate-funds).


## View payout requests

Use this process to view customer payout requests.

1. In the left navigation bar, press , then press **Payments**.
2. Press **Payout requests**, then in the **ID** column, press a payout request ID.


### Filter payout requests

Use this process to filter payout requests by their current status.

1. In the left navigation bar, press , press **Payments**, then press **Payout requests**.
2. In the top right of the table, press .
3. In the **Filter** dropdown, select **Status**.
4. In the **Operation** dropdown, select **is in**.
5. In the **Value** field, select one or more of the following:
  - Pending: Payout request is created but the customer has not responded.
  - Instrument-selected: Payout request is created and the customer has selected their payment instrument.
  - Partially-fulfilled: Payout request is partially paid.
  - Fulfilled: Payout request is paid in full.
6. Press **Apply filter**.
7. Optionally, to create a new segment based on the filtered data, press **Save segment as**. Then, enter a name for the new segment, and press **Save**.


A segment is a filtered view of a data set. To add or manage segments, or to apply or edit filters on a segment, see [Segments](/docs/settings/segments).

## Allocate funds

Use this procedure to process a customer's payout request and to allocate funds to the related payment instrument.

To retry an allocation, repeat this process. You may retry the allocation on the same payment instrument, or choose a new payment instrument.

1. In the left navigation bar, press , then press **Payments**.
2. Press **Payout requests**, then in the **ID** column, press a payout request ID. 
In the table, all available payment instruments that can receive a payout are displayed. Specific payment instruments may be displayed more than once if they have been processed through separate gateways. Each line in the table represents different exposure on the specific payment instrument.
3. In the **Allocate** field, enter the amount you want to payout to a specific payment instrument and through a specific gateway. You may choose payment instruments which have not been used yet.
4. In the top right, to allocate the funds to the payout request, press **Allocate**.


## Cancel a payout request

Use this process to cancel a payout request. A payout request can only be canceled if it has the `pending` or `instrument-selected` status.

1. In the left navigation bar, press , then press **Payments**.
2. Press **Payout requests**, then in the **ID** column, press a payout request ID.
3. In the top right, press **Cancel**.
4. In the **Cancellation reason** field, enter a reason for the cancellation.
5. In the **Canceled by** section, specify if the payout request was canceled by the customer or merchant.
6. Press **Cancel payout request**.


## Request a payout

Use this process to generate a payout request form link and to share it with a customer. Payout request forms enable customers to select a payment instrument for their payout. The unique link can be used in customer emails or live chat. This process is often used by Customer Support Representatives.

To generate a request payout link for a customer:

1. In the navigation bar, press , and press **Customers**.
2. In the list of customers, select the customer that you would like to share the request payout link with.
3. In the top right of the screen, press , then press **Request payout**.
4. Optionally, if you have configured custom domains, in the **Custom domain** field, select a domain. For more information, see [Configure a custom domain](/docs/settings/organizations-and-websites#configure-a-custom-domain).
5. Optionally, if more than one website is associated with your organization, in the **Website ID** field, select a website. For more information, see [My organizations and websites](/docs/settings/organizations-and-websites#my-organizations-and-websites).
6. In the **Currency** field, select the currency for the payout.
7. In the **Amount** field, enter the amount for the payout request.
8. Optionally, in the **Redirect URL** field, enter a URL where the customer is redirected after they select a payment instrument. 
To inject the payout request ID into the redirect URL, use `{{id}}` as a placeholder for the payout request ID. Example: `https://www.example.com?id={{id}}`.
9. Press **Generate URL**.
10. Copy the URL and share it with the customer.


## Provide a payment instrument for a payout request

This process describes how the customer provides a payment instrument for a payout request that is generated on their behalf, using the [Request a payout](#request-a-payout) procedure.

1. The customer visits a URL that is generated using the [Request a payout](#request-a-payout) procedure.
2. The customer selects a payment instrument or enters a new payment instrument.
3. The customer clicks **Continue** to submit the payout request.


## Configure a gateway for payouts

To configure how a gateway manages payout requests, set the ready to payout instruction in gateway account settings. For more information, see [Set up a gateway for payments](/docs/settings/set-up-a-gateway).

## Configure payout methods

To configure which payment methods are displayed when a customer requests a payout, see [Adjust ready to payout](/docs/automations/action-types#adjust-ready-to-payout).

## Related topics

- [Set up a gateway](/docs/settings/set-up-a-gateway)
- [Adjust ready to payout](/docs/automations/action-types#adjust-ready-to-payout)
- [Ready to pay requested](/docs/automations/event-types#ready-to-pay-requested)
- [Customize tables](/docs/data-tables/customize-tables)
- [Manage logs](/docs/data-tables/manage-logs)
- [Manage payments](/docs/data-tables/manage-payments)
- [Segments](/docs/settings/segments)