# Payment links concept

**Payment Links** are an add-on feature for Invoices and Payouts. While both [Invoices](https://docs.txn.io/invoices/creating-invoice) and [Payouts](https://docs.txn.io/payouts/creating-payout) can be created independently with predefined cryptocurrencies and networks via dedicated endpoints, Payment Links enable merchants to extend the payment flow. By creating a Payment Link, you can redirect customers and end-users to a Payment Link page hosted by Txn, where they can select the cryptocurrency and network they prefer to use for payment.

## Types of Payment Links

### Invoice Payment Links

These links initiate the creation of invoices and emit invoice webhook messages to notify merchants about the status of invoice payments.

<figure><img src="https://1963856601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgfUDRstNYYBTf2futZ28%2Fuploads%2FRLIwpDpp2ASOCJ1rDHtX%2Finvoice%20payment%20link%20flow.svg?alt=media&#x26;token=b6af6b99-2977-4170-bc0c-d787b0cd994b" alt=""><figcaption></figcaption></figure>

Read more about the [Invoices Concept](https://docs.txn.io/invoices/invoices-concept) and [Invoice Payment Flow](https://docs.txn.io/invoices/invoice-status-flow) to gain a complete understanding of how the entire process works.

### Payout Payment Links

These links perform a similar function for payouts, triggering the creation of payouts and emitting corresponding webhook messages to update merchants on payout statuses.

<figure><img src="https://1963856601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgfUDRstNYYBTf2futZ28%2Fuploads%2FMyGDWxTgPMgOMYL6j4y1%2Fpayout%20payment%20link%20flow.svg?alt=media&#x26;token=e5b277c9-be4f-43a7-ae20-b9a3a69073fa" alt=""><figcaption></figcaption></figure>

Read more about the [Payouts Concept](https://docs.txn.io/payouts/payouts-concept) and [Payout Payment Flow](https://docs.txn.io/payouts/payout-status-flow) to gain a complete understanding of how the entire process works.

## List of Payment Link States

Payment Links do not share their statuses with child Invoices and Payouts; they are independent entities. Refer to the list of Payment Link statuses in the table below.

For information on possible statuses for Invoices and Payouts, please refer to the corresponding documentation:

* [Invoice status flow](https://docs.txn.io/invoices/invoice-status-flow)
* [Invoice webhooks](https://docs.txn.pro/api-basics/webhooks/webhook-payload-examples/invoice)
* [Payout status flow](https://docs.txn.io/payouts/payout-status-flow)
* [Payout webhooks](https://docs.txn.pro/api-basics/webhooks/webhook-payload-examples/payout)

| Status    | Final? | Description                                                                                                                                                                                                                                        |
| --------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| created   | N      | This is the initial status of the Payment Link, which will later update to either **Pending** if your end-user takes action, **Completed** if your end-user completes the payment or **Expired**.                                                  |
| pending   | N      | The status **Pending** means that the end-user has triggered the creation of a child invoice or payout via the payment link. If they complete the payment, the payment link status updates to **Completed.** Otherwise, it changes to **Expired.** |
| completed | Y      | This is the final status, indicating that your end-user has successfully initiated a child Invoice or Payout through the Payment Link. As a result, the Payment Link is considered **Completed**.                                                  |
| expired   | Y      | This is the final status, indicating that your end-user did not proceed with initiating their deposit or withdrawal transaction while the Payment Link was pending.                                                                                |

## Payment Link UI Examples

### Invoice Payment Links

A Payment Link is created to allow an end-user to select their preferred cryptocurrency (coin) and network for completing a transaction:

<figure><img src="https://1963856601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgfUDRstNYYBTf2futZ28%2Fuploads%2FQWMhkdXF42NzFRFOIMoj%2FScreenshot%202025-01-12%20at%2011.23.38.png?alt=media&#x26;token=3050840d-56c5-4291-b985-eb5f7b691c54" alt=""><figcaption></figcaption></figure>

After clicking **Continue**, Txn creates an invoice and redirects the end-user to the invoice page hosted by Txn:

<figure><img src="https://1963856601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgfUDRstNYYBTf2futZ28%2Fuploads%2FPb8RYiaf9LlkiO7rVZKT%2FScreenshot%202025-01-12%20at%2011.23.45.png?alt=media&#x26;token=089ce39b-d62b-45c1-9699-ffe14dacaed9" alt=""><figcaption></figcaption></figure>

***

### Payout Payment Links

A Payment Link is created to enable an end-user to select their preferred cryptocurrency (coin) and network, as well as submit their wallet address to complete the transaction:

<figure><img src="https://1963856601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgfUDRstNYYBTf2futZ28%2Fuploads%2FI49rkgZpH3ZwctEElfB4%2FScreenshot%202025-01-12%20at%2011.45.13.png?alt=media&#x26;token=1e4f24db-4110-42ff-851b-1ee39412f787" alt=""><figcaption></figcaption></figure>

After clicking **Continue**, the end-user is prompted to review their payout details before the cryptocurrency transaction is sent to their wallet address:

<figure><img src="https://1963856601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgfUDRstNYYBTf2futZ28%2Fuploads%2Fr3j96mC5aNvCOGVSiIgF%2FScreenshot%202025-01-12%20at%2011.46.40.png?alt=media&#x26;token=046544d1-90dd-4dd1-9f03-c7e0b67a0233" alt=""><figcaption></figcaption></figure>

After clicking **Confirm**, Txn initiates a cryptocurrency transaction to the end-user's wallet address:

<figure><img src="https://1963856601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgfUDRstNYYBTf2futZ28%2Fuploads%2F1LfoCBsgKYorEdbjI8Sg%2FScreenshot%202025-01-12%20at%2011.46.48.png?alt=media&#x26;token=545dcfce-a502-44c8-89b4-c5c492019f3b" alt=""><figcaption></figcaption></figure>
