Install a Private Supplier Relay

Use Private Relay only when you can host and maintain an HTTPS endpoint with PHP 8.2 or newer and cURL for the selected supported driver. Open **Orders → Supplier APIs**, add or edit the connection, and review the driver’s relay availability before changing a working connection.

Enable and install

1. Enable **Private Relay**. The form generates relay credentials and removes local supplier fields from the cloud connection form.

2. Select **Download PHP Relay**. The installed URL is not required merely to download the generated file.

3. Configure the downloaded PHP file with the supplier-specific values on your own server, following the generated setup instructions.

4. Host it at the intended public HTTPS URL using PHP 8.2 or newer with cURL available.

5. Enter the **Private Relay URL** in Fusion. Keep the signing key and connection ID consistent with the installed relay.

6. Select **Test Connection**. After a successful result, select **Save**.

Test and Save need the installed URL; downloading the file alone does not create a running relay. The signing key is private connection material. Do not post it, the configured PHP file or supplier credentials in a public article or support message.

Understand the split

Supplier-specific local fields belong on your relay server. Display name, currency and public operational settings remain in Fusion. Enabling relay clears local connection fields from the cloud form; disabling it later does not restore those credentials automatically.

**Expected result:** Test Connection reports a successful local connection and the saved Fusion connection points to the installed endpoint. This verifies the connection path, not a completed customer order or supplier transaction. Use an approved controlled workflow for any real fulfillment test.

Related guides

Troubleshoot a Private Relay connection

Add a supplier API connection