---
title: "Udostępnianie linku do faktury"
description: "Jak utworzyć dla klienta publiczny link do faktury lub link do płatności online."
---

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

# Udostępnianie linku do faktury

Link do faktury otwiera fakturę bez logowania, z możliwością pobrania. Link do płatności prowadzi od razu do płatności online.

> **Przykłady korzystają z sandboxa**
>
> Wszystkie przykłady na tej stronie wysyłają żądania do środowiska testowego (`https://api.sandbox-infakt.pl/v3`). Na produkcji należy użyć adresu `https://api.infakt.pl/v3` i klucza API z konta produkcyjnego.

## Wymagania

- Klucz API z zakresem `api:invoices:write` w zmiennej `INFAKT_API_KEY`.
- `id` faktury w zmiennej `INVOICE_ID`.

## Kroki

1. **Utworzenie linku do faktury**

   ```sh
   curl -X POST "https://api.sandbox-infakt.pl/v3/invoices/$INVOICE_ID/share_links.json" \
     -H "X-inFakt-ApiKey: $INFAKT_API_KEY"
   ```

   ```js
   const res = await fetch(`https://api.sandbox-infakt.pl/v3/invoices/${process.env.INVOICE_ID}/share_links.json`, {
     method: "POST",
     headers: {
       "X-inFakt-ApiKey": process.env.INFAKT_API_KEY,
     },
   });
   const data = await res.json();
   console.log(res.status, data);
   ```

   ```python
   import os
   import requests

   res = requests.post(
       f"https://api.sandbox-infakt.pl/v3/invoices/{os.environ['INVOICE_ID']}/share_links.json",
       headers={"X-inFakt-ApiKey": os.environ["INFAKT_API_KEY"]},
   )
   print(res.status_code, res.json())
   ```

   ```php
   <?php
   $ch = curl_init('https://api.sandbox-infakt.pl/v3/invoices/' . getenv('INVOICE_ID') . '/share_links.json');
   curl_setopt_array($ch, [
       CURLOPT_CUSTOMREQUEST => 'POST',
       CURLOPT_RETURNTRANSFER => true,
       CURLOPT_HTTPHEADER => [
           'X-inFakt-ApiKey: ' . getenv('INFAKT_API_KEY'),
       ],
   ]);
   $response = curl_exec($ch);
   $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
   echo $status, ' ', $response, PHP_EOL;
   ```
2. **Utworzenie linku do płatności (opcjonalnie)**

   ```sh
   curl -X POST "https://api.sandbox-infakt.pl/v3/invoices/$INVOICE_ID/quick_payments.json" \
     -H "X-inFakt-ApiKey: $INFAKT_API_KEY"
   ```

   ```js
   const res = await fetch(`https://api.sandbox-infakt.pl/v3/invoices/${process.env.INVOICE_ID}/quick_payments.json`, {
     method: "POST",
     headers: {
       "X-inFakt-ApiKey": process.env.INFAKT_API_KEY,
     },
   });
   const data = await res.json();
   console.log(res.status, data);
   ```

   ```python
   import os
   import requests

   res = requests.post(
       f"https://api.sandbox-infakt.pl/v3/invoices/{os.environ['INVOICE_ID']}/quick_payments.json",
       headers={"X-inFakt-ApiKey": os.environ["INFAKT_API_KEY"]},
   )
   print(res.status_code, res.json())
   ```

   ```php
   <?php
   $ch = curl_init('https://api.sandbox-infakt.pl/v3/invoices/' . getenv('INVOICE_ID') . '/quick_payments.json');
   curl_setopt_array($ch, [
       CURLOPT_CUSTOMREQUEST => 'POST',
       CURLOPT_RETURNTRANSFER => true,
       CURLOPT_HTTPHEADER => [
           'X-inFakt-ApiKey: ' . getenv('INFAKT_API_KEY'),
       ],
   ]);
   $response = curl_exec($ch);
   $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
   echo $status, ' ', $response, PHP_EOL;
   ```

## Weryfikacja

Link do faktury ma określoną datę ważności:

```json
{
  "share_link": "https://www.infakt.pl/app/twoja-faktura/4d7c2a1e-6b3f-4e8a-9c5d-0f1e2d3c4b5a",
  "expiration_date": "2026-11-01"
}
```

Link do płatności:

```json
{
  "payment_link": "https://www.infakt.pl/app/twoja-faktura/platnosc/9bdc76fd-7a02-42ec-a4a3-42bc867b9a9f"
}
```

Ważność linku można przedłużyć żądaniem `POST /invoices/{invoice_id}/share_links/prolong.json`. Kod `403` z `limit: cant_print_invoice` oznacza wyczerpanie limitu wydruków w planie.

## Następne kroki

- [Wysyłka faktury e-mailem](/poradniki/fakturowanie/wyslij-e-mailem/)
- [Operacja w referencji API](/api/invoice-sharing-create-share-link/)

Source: https://docs.niebieskiorzel.pl/poradniki/fakturowanie/udostepnij-link/index.mdx