Custom Webhook Integration

If your software isn't directly supported by FiscoBridge, you can use a custom webhook integration to send invoice events to any HTTP endpoint — or use the Custom Integration option to get API credentials and integrate directly.

Option 1: Webhook Integration

Webhooks let FiscoBridge send invoice events to your system automatically.

Setting Up a Webhook

1. Go to Integrations → Integrations in the sidebar

2. Click Create Integration

3. Select the Custom / Webhook card

4. Configure the webhook:

   • Endpoint URL — The HTTP endpoint where FiscoBridge will send events

   • Headers — Any custom headers your endpoint requires (e.g., authentication tokens)

5. Click Save

Once created, FiscoBridge sends invoice events to your endpoint as they occur.

Webhook Payload

Events are sent as HTTP POST requests with a JSON body containing the invoice data, including invoice number, items, totals, fiscal signature, and verification URL.

Option 2: Custom Integration (API Access)

For full control, create a Custom Integration to get API credentials. This lets your system call the FiscoBridge API directly to create, retrieve, and manage fiscal invoices.

Setting Up API Access

1. Go to Integrations → Integrations in the sidebar

2. Click Create Integration

3. Select the Custom Integration card (marked as Premium)

4. The integration is created and linked to a specific certificate

Managing API Keys

1. In the Integrations list, find your Custom Integration

2. Click the API Keys button

3. You'll be taken to the API Keys page for that integration

Creating a key:

1. Click Create API Key

2. Enter a label/name for the key

3. The system generates a Client ID and Client Secret

Important: The client secret is shown only once. Copy and store it securely — you cannot retrieve it later.

Using the API

Authenticate your requests with the X-Api-Key header:

The API key is bound to a specific certificate, which is used automatically for invoice signing.

Revoking an API Key

1. Go to the API Keys page for your integration

2. Click Revoke next to the key

3. Confirm the action

Revoked keys immediately stop working. Create a new key if you need to restore access.

Requirements

• An active Cloud POS subscription (required for API access)

• At least one active certificate uploaded

Next Steps

• Manage integrations — View and manage all your connections

• Integrations Overview — Learn about other supported platforms