# Payout Links

Payout Links are one-time use links to send a payout to a recipient. You can email or text the link to your recipient. If conducting a card payout, funds are usually available in minutes.

You can use payout links to send insurance payouts, sales commissions, and more. You can customize the payout link with your brand name and logo.

In this guide, you will learn how to create payout links on the Finix Dashboard and via API

## Recipient Experience

When a recipient clicks on the link, they'll see where they can enter their card or bank information to receive their payout. This experience can be white-labeled to have your brand colors and logo.

![Payout Link Recipient Experience](/assets/payout-link-recipient-experience-v2.3c95f1095b9981f581c0145ee47459d847a7874d425db0bb1f8380c2b68cac18.08ff7529.png)

- **Personal Recipients:** For personal recipients, `first_name`, `last_name`, and `personal_address` are required in addition to the payment instrument.
- **Business Recipient:** For business recipients, `business_name`,`doing_business_as`, and `business_address` are required. In addition, we require a control owner with `first_name`, `last_name`, and `personal_address`.


Once they enter their information, Finix will review and conduct standard underwriting checks. If the recipients are approved, a card or bank payout will be sent.

Recipients can re-visit the link to check the status of their payout. If the payout fails, they'll be asked to re-enter their information. If the recipient is under Manual Review, we may need additional documentation to clear the recipient. Please see our [verification process guide](/guides/payouts/recipient-verification-process) for more details.

## Create a Payout Link using the Finix Dashboard

You can create a payout link in the Finix Dashboard without any development work. Using the Finix Dashboard, you can:

- Create and send payout links to recipients to receive funds
- Track the status of payout links.


### Step 1: Create a Payout Link

To create a payout link in the Finix Dashboard:

1. Log into the Finix Dashboard.
2. Click Payout Link on the left navigation bar.
3. Click Create Payout Link
4. Fill out the form with the requested details. Be sure to include a link to your Terms of Service.


![Create a Payout on Dashboard](/assets/payout-link-insurance-v2.1cdfb195b58e4402d06aea447dc5010ae9224d8d94a9aad911c96d0c863102a3.08ff7529.png)

### Step 2: Send Payout Link to Recipient

On the **Payout Link Details** page, you can copy the payout link URL to send to buyers.

When the recipient clicks on the link, they will be redirected to Finix's payout form to complete their payout.


```url Example Payout Link URL
https://link.sandbox-payments-checkout.com/Mx4yvg
```

### Step 3: Track your Payout Link

After you create a payout link, you can track the payout link status on the Finix Dashboard. You can review the information again on the Finix Dashboard. On the detail page, you can copy the URL again or deactivate a payout link.

![Payout Link Detail Page](/assets/payout-link-detail-page-v2.2861769e90f2590f1511033e441ce296e4a864c3cb5370202c4784e0dc5e035f.08ff7529.png)

If you click on **Payout Attempts**, you can view `payout attempts` in a `PENDING`, `SUCCEEDED`, or `FAILED` state. A `payout attempt` that is `PENDING` is actively being underwritten.

## Create a Payout Link via API

To create a `Payout Link`, include:

- The amount of the transaction.
- Any additional URLs (Terms of Service required).
- Allowed payment methods.


Example
API Definition
A successful request returns a `201 Created` status code and includes a `Payout Link` resource in the response.

Example
Payout Link

```json Payout Link
{
  "id": "payout_link_ches9gZg2WWM7ARM53pmP",
  "additional_details": {
    "success_return_url": null,
    "unsuccessful_return_url": null,
    "expired_session_url": null,
    "terms_of_service_url": "https://example.com/terms",
    "expiration_in_minutes": 10080
  },
  "allowed_payout_operations": [
    "PUSH_TO_ACH",
    "PUSH_TO_CARD"
  ],
  "amount_details": {
    "total_amount": 100000,
    "currency": "USD"
  },
  "application_id": "AP5Tq3MMxKwHYX7soDncrCQ3",
  "branding": {
    "brand_color": "#0D121A",
    "accent_color": "#0B5DBC",
    "logo": "https://s3-us-west-2.amazonaws.com/payments-dashboard-assets/dashboard.finixpayments.com/2022-04-28-22_56_33-finix-logo-v2.png",
    "icon": "",
    "logo_alternative_text": null,
    "button_font_color": "#FFFFFF"
  },
  "created_at": "2024-11-15T10:07:50.353254Z",
  "items": [
    {
      "name": "Insurance Payout #2552",
      "image_details": {
        "primary_image_url": "https://upload.wikimedia.org/wikipedia/commons/thumb/8/88/Uninsured_cars_seized_by_police_in_Liverpool.JPG/220px-Uninsured_cars_seized_by_police_in_Liverpool.JPG",
        "alternative_image_urls": []
      },
      "price_details": {
        "amount": 100000,
        "currency": "USD"
      },
      "description": "Car Damage",
      "quantity": 1
    }
  ],
  "link_expires_at": "2024-11-22T10:07:50.335572Z",
  "link_url": "https://link.sandbox-payments-checkout.com/Xjts64",
  "nickname": "Insurance Claim #2552",
  "recipient_details": null,
  "state": "ACTIVE",
  "tags": {
    "collectPhoneNumber": false,
    "collectEmail": false
  },
  "updated_at": "2024-11-15T10:07:50.596865Z",
  "_links": {
    "self": {
      "href": "https://finix.sandbox-payments-api.com/payout_links/payout_link_ches9gZg2WWM7ARM53pmP"
    }
  }
}
```

API Definition
## Successful Payouts

When a recipient successfully receives their payout, the `status` of the payout link updates to `COMPLETED`.