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

# Payment request backlinks

The AlphaPo payment request webpage may include a **Return to merchant** link with a URL that you provide. It is good practice to use these webpages to inform the customer about the successful purchase or let them retry a failed one.

This customization is only available when creating a payment request via the [API endpoint](/api-reference/endpoints/payments). You can provide different webpages for different states of the process via the [url\_store](#url-store), [url\_success](#url-success) and [url\_failed](#url-failed) parameters.

<Frame>
  <img src="https://mintcdn.com/alphapo/upIXj5ePwoDGAt-s/images/payment-requests/payment-request-url-store.png?fit=max&auto=format&n=upIXj5ePwoDGAt-s&q=85&s=fce1bf482bf7791949b41b7f0e2bc598" alt="url_store" style={{ width:"33%" }} width="1064" height="1591" data-path="images/payment-requests/payment-request-url-store.png" />

  <img src="https://mintcdn.com/alphapo/upIXj5ePwoDGAt-s/images/payment-requests/payment-request-url-success.png?fit=max&auto=format&n=upIXj5ePwoDGAt-s&q=85&s=ed07e07dfc2e81af85eec0b68799fd59" alt="url_success" style={{ width:"33%" }} width="1064" height="1591" data-path="images/payment-requests/payment-request-url-success.png" />

  <img src="https://mintcdn.com/alphapo/upIXj5ePwoDGAt-s/images/payment-requests/payment-request-url-failed.png?fit=max&auto=format&n=upIXj5ePwoDGAt-s&q=85&s=b3a405c6b3233fc4425ac72eb7454fe7" alt="url_failed" style={{ width:"33%" }} width="1064" height="1591" data-path="images/payment-requests/payment-request-url-failed.png" />
</Frame>

<Note>
  It is not guaranteed that the customer will click the link. Instead, they may immediately close the tab with the AlphaPo interface after sending the transaction. The only reliable way to get notified about the payment request status is to process [API callbacks](/api-reference/callbacks/payment-request-callbacks).
</Note>

## url\_store

The `url_store` link will be shown under the payment request form while it is still processing (neither successful nor cancelled).

This URL is also used as the default value for `url_success` and `url_failed` in case you don't specify them.

## url\_success

The `url_success` link will be used for the button on the final screen of the payment request interface.

A customer only sees this button when they successfully completed the payment request. Your site will have already received the [Payment request paid](/api-reference/callbacks/payment-request-callbacks#payment-request-paid) callback.

## url\_failed

The `url_failed` link will be used for the button on the ‘Payment request expired’ screen.

A customer only sees this button when they failed to fulfill the requested amount within the [lifespan](/payment-requests#lifespan-and-rate-lock). Your site will have already received the [Payment request failed](/api-reference/callbacks/payment-request-callbacks#payment-request-failed) callback.
