> For the complete documentation index, see [llms.txt](https://developer.branta.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.branta.pro/setup/receive/integrations/btcpay-server.md).

# BTCPay Server

Install the [Branta plugin](https://plugin-builder.btcpayserver.org/public/plugins/branta).

[Voltage](https://www.voltage.cloud), [BTCPay Italia](https://www.btcpayserver.it), and [Bitcoin Aruba](https://btc.aw) already have Branta installed.

## 1. Install

Log in to BTCPay Server and click Manage Plugins.

{% hint style="warning" %}
If you don't see Manage Plugins, an admin has to do this for you.
{% endhint %}

Search `Branta` and click Install. BTCPay Server will restart.

<figure><img src="https://2482615079-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWfLyw4XD5FjUVq3GxTZN%2Fuploads%2FimNqkT2IBFXrmiU0jMPH%2FScreenshot%202025-11-06%20140300.png?alt=media&amp;token=e2036d1f-b963-421e-ba15-aeddc8381f18" alt=""><figcaption></figcaption></figure>

Branta appears under Plugins.

<figure><img src="https://2482615079-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWfLyw4XD5FjUVq3GxTZN%2Fuploads%2FBicUPWEtbFChak02WVvK%2FScreenshot%202025-08-30%20at%2009.10.21.png?alt=media&amp;token=b35aac5a-4625-4ae7-9075-fc6b6adbaf0c" alt=""><figcaption></figcaption></figure>

## 2. API key and enable

Under Plugins, click Branta. Paste the API key from your Branta dashboard, turn on Enable Branta, and click Save.

<figure><img src="https://2482615079-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWfLyw4XD5FjUVq3GxTZN%2Fuploads%2Fz0spn4dt8O4e7wPVOWms%2FScreenshot%202025-11-06%20140810.png?alt=media&amp;token=17d2cb8e-e201-414e-b349-1f19bc246147" alt=""><figcaption></figcaption></figure>

## 3. Advanced settings (optional)

Expand **Advanced** on the settings page to change defaults:

* **Enable Staging** and **Staging API Key** — point the plugin at `staging.guardrail.branta.pro`. Use a staging API key.
* **Show Checkout Info on Verification Page** — include the invoice description on the Branta verify page.
* **Allow Guardrail Verification for** — how long each published destination stays valid. Options: 30 minutes (default), 4 hours, 1 day, 7 days.
* **Show Verify Link at Checkout** — whether `Click to verify with Branta` appears on invoices.

## 4. Verify

Create a test invoice. Checkout shows `Click to verify with Branta`.

You can also [QR scan](https://scan.branta.pro/scan) the invoice.

<figure><img src="https://2482615079-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWfLyw4XD5FjUVq3GxTZN%2Fuploads%2Fw93WqvI1LsSmU1e7IBvn%2Fbtcpay-btc.png?alt=media&amp;token=3ea97d6f-a712-49fb-84e0-91d49ba612a7" alt=""><figcaption></figcaption></figure>