Zbieranie adresów klientów w Stripe

Dlaczego adres jest potrzebny

Systemy księgowe (Fakturownia, inFakt, wFirma) wymagają danych nabywcy do wystawienia faktury. Minimalne dane to nazwa (imię i nazwisko lub nazwa firmy) oraz adres rozliczeniowy.

Jeśli klient zapłaci w Stripe bez podania tych danych, Stripto nie będzie mogło wystawić faktury i wyświetli błąd:

Rozwiązaniem jest skonfigurowanie Stripe tak, aby zbierał adres rozliczeniowy podczas płatności. Poniżej znajdziesz instrukcje dla każdego scenariusza.

Stripe Checkout

Stripe Checkout to gotowy formularz płatności hostowany przez Stripe. Zbieranie adresu rozliczeniowego możesz włączyć w ustawieniach Stripe lub przez API.

Przez Stripe Dashboard

1. Wejdź w Settings → Checkout and Payment Links
2. Znajdź sekcję Customer information
3. Włącz opcję Collect billing address
4. Zapisz zmiany

Ustawienie działa globalnie dla wszystkich nowych sesji Checkout.

Przez kod (API)

Jeśli tworzysz sesje Checkout programistycznie, ustaw parametr billing_address_collection na required:

const session = await stripe.checkout.sessions.create({
  // ...inne parametry
  billing_address_collection: "required",
});

Payment Links

Payment Links to linki płatnicze, które można udostępnić klientom bez pisania kodu. Aby włączyć zbieranie adresu:

1. Otwórz istniejący Payment Link lub utwórz nowy w Stripe Dashboard → Payment Links
2. W sekcji Options zaznacz Collect customer addresses
3. Wybierz tryb zbierania adresu:
   • Billing addresses only – zbiera tylko adres rozliczeniowy. Wystarczający do wystawiania faktur
   • Billing and shipping addresses – zbiera dodatkowo adres dostawy. Wybierz tę opcję, jeśli wysyłasz fizyczne produkty

   Do celów fakturowania wystarczy opcja Billing addresses only.

4. Zapisz Payment Link

Zbieranie NIP (Tax ID)

Przy okazji konfiguracji Payment Link warto włączyć zbieranie numerów identyfikacji podatkowej. Dzięki temu klienci firmowi (B2B) będą mogli podać swój NIP podczas płatności, a Stripto automatycznie umieści go na fakturze.

1. W edytorze Payment Link rozwiń sekcję Advanced options
2. Zaznacz Allow business customers to provide tax IDs
3. Zapisz Payment Link

Subskrypcje i Customer Portal

Dla subskrypcji adres rozliczeniowy jest zapisywany na obiekcie Customer w Stripe. Możesz go ustawić na kilka sposobów:

Przy tworzeniu subskrypcji przez Checkout

Użyj tego samego parametru billing_address_collection: "required" w sesji Checkout w trybie subscription. Adres zostanie automatycznie zapisany na kliencie.

Customer Portal

Jeśli korzystasz z Customer Portal (portalu klienta Stripe), klient może sam zaktualizować swój adres rozliczeniowy. Aby to umożliwić:

1. Wejdź w Settings → Billing → Customer Portal
2. Upewnij się, że opcja Customer information → Billing address jest włączona
3. Zapisz zmiany

Przez API

Możesz też ustawić adres bezpośrednio na kliencie przez API:

await stripe.customers.update("cus_xxx", {
  address: {
    line1: "ul. Przykładowa 1",
    city: "Warszawa",
    postal_code: "00-001",
    country: "PL",
  },
  name: "Jan Kowalski",
});

Co zrobić, gdy klient już zapłacił bez adresu

Jeśli płatność została zrealizowana, ale klient nie podał adresu, możesz uzupełnić dane ręcznie i ponowić synchronizację:

1. Uzupełnij dane klienta w Stripe Dashboard:
   • Wejdź w Customers i znajdź klienta
   • Kliknij Edit (lub Details → Edit)
   • Uzupełnij pola Name i Billing address
   • Zapisz zmiany
2. Ponów synchronizację w Stripto:
   • Wejdź w panel Stripto i znajdź fakturę ze statusem błędu
   • Kliknij Ponów synchronizację
   • Stripto pobierze zaktualizowane dane klienta ze Stripe i wystawi fakturę