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

# Płatność w trakcie rozmowy (Stripe)

> Agent wysyła SMS-em jednorazowy link do płatności i sprawdza, czy wpłata doszła, zanim rozmówca się rozłączy.

## Co to robi

W trakcie rozmowy agent może przyjąć płatność: zaliczkę za wizytę, opłatę za
rezerwację, zaległą fakturę. Nazywa kwotę i za co jest, a po zgodzie
rozmówcy tworzy w Twoim koncie Stripe **jednorazowy link do płatności**
i wysyła go SMS-em na numer dzwoniącego. Rozmówca płaci w telefonie (BLIK,
Przelewy24, karta, zależnie od ustawień konta), a agent narzędziem
`check_payment_status` sprawdza w Stripe, czy wpłata doszła, i potwierdza ją
jeszcze w rozmowie.

Link jest ograniczony do jednej zakończonej płatności, więc dwukrotne
kliknięcie nie oznacza dwóch wpłat.

## Konfiguracja

1. W Stripe: **Developers → API keys** utwórz **klucz ograniczony**
   (restricted key) z prawem zapisu do Payment Links, Products i Prices oraz
   odczytu Checkout Sessions. Klucz tajny (`sk_`) też zadziała; klucz
   publiczny (`pk_`) nie, i test połączenia to powie.
2. **Integracje → Stripe**: wklej klucz, opcjonalnie walutę (domyślnie PLN)
   i nazwę firmy, która pojawi się w SMS-ie. **Testuj połączenie** czyta
   konto i sprawdza, czy może przyjmować płatności.
3. W Stripe **Settings → Payment methods** włącz BLIK i Przelewy24, żeby
   polscy klienci płacili w aplikacji banku zamiast przepisywać kartę.
4. Edytor agenta → **Integracje** → **Link do płatności w rozmowie**:
   wybierz połączenie i napisz, kiedy agent może prosić o płatność, np.
   „zaliczka 50 zł przy umawianiu pierwszej wizyty; zaległe faktury według
   kwoty podanej przez rozmówcę".

<Note>
  SMS wychodzi z numeru agenta, więc agent musi mieć przypisany numer, który
  wysyła SMS-y (numery plfon i Telnyx tak). Bez numeru narzędzie odpowie
  błędem, a agent powie, że nie może wysłać linku.
</Note>

## Co widzi rozmówca

SMS w rodzaju: `Studio Fit: Zaliczka za wizytę 15.10 - 50,00 PLN. Zapłać
tutaj: https://buy.stripe.com/...`. Po otwarciu strona Stripe z metodami
płatności konta i po zapłacie potwierdzenie.

## Co widzisz Ty

* W **Integracje → Dostawy** każdy link: kwota, opis, numer, adres linku
  i czy SMS wyszedł. Adres pozwala odnaleźć płatność w panelu Stripe.
* W Stripe link ma metadane `brosbots_run` (id rozmowy) i `phone`.

## Narzędzia agenta

| Narzędzie | Co robi |
| - | - |
| `send_payment_link(amount, description, to?)` | tworzy cenę i jednorazowy link, wysyła SMS |
| `check_payment_status(payment_link_id?)` | czy ostatni link z tej rozmowy został opłacony |

Kwotę agent podaje w jednostkach waluty (`49.90`); „49,90" i „50 zł" też są
rozumiane. Kwota nieliczbowa albo zerowa jest odrzucana przed wysłaniem
czegokolwiek do Stripe.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.