# Metody płatności

{% hint style="danger" %}
**Musisz** utworzyć co najmniej jedną metodę płatności, zanim otworzysz sklep.
{% endhint %}

## Konfiguracja metody płatności

* Wejdź na stronę metod płatności, klikając **Enterprises** w głównym poziomym menu, a następnie **Settings** obok swojego przedsiębiorstwa. Strona **Payment Methods** znajduje się w menu po lewej stronie.
* Kliknij **Create new payment method +**. Zostaniesz przeniesiony na stronę podobną do tej:
* Zaznacz swoje przedsiębiorstwo w polu po prawej stronie zatytułowanym „Hubs”. To wskazuje, do których przedsiębiorstw będzie miała zastosowanie metoda płatności. Możesz wybrać więcej niż jedno przedsiębiorstwo.
* **Name:** Wybierz nazwę metody płatności (np. „Płatność kartą przez PayPal”). Ta nazwa jest wyświetlana przy checkout i w e-mailach z potwierdzeniem zamówienia.
* **Description:** Podaj dodatkowe szczegóły metody płatności. Na przykład przy przelewie wpisz dane konta bankowego, na które klient ma wykonać płatność BACS. Opis jest wyświetlany przy checkout i w e-mailach z potwierdzeniem.
* **Display:** Wybierz „Back Office Only” lub „Both Checkout and Back Office”.

{% hint style="info" %}
Jeśli chcesz tymczasowo wyłączyć metodę płatności, ale planujesz ją później przywrócić (np. z powodu sytuacji jak COVID chcesz na jakiś czas wyłączyć gotówkę przy odbiorze), ustaw ją na „Back Office Only”.
{% endhint %}

{% hint style="warning" %}
Ustawienie wszystkich metod płatności przedsiębiorstwa na „Back Office Only” spowoduje [front sklepu tylko do wyświetlania](/smaki-wsi-docs/basic-features/shopfront/display-only-order-cycles.md) dla aktywnych cykli zamówień.
{% endhint %}

* **Active:** Wybierz, czy metoda płatności ma być widoczna i dostępna.
* **Tags:** Użyj reguł tagów, jeśli chcesz udostępniać/ukrywać wybrane metody płatności dla konkretnych klientów (np. tylko klienci hurtowi mogą płacić BACS, a klienci detaliczni są „zmuszeni” do płatności kartą lub PayPal). Więcej informacji [tutaj](/smaki-wsi-docs/basic-features/shopfront/customer-management-and-conditional-displays-prices.md).
* **Payment providers**: Wybierz opcję odpowiednią dla tworzonej metody płatności. Są trzy opcje:
  * PayPal Express
  * Stripe SCA
  * Cash / EFT / etc. (gotówka, czek lub przelew bankowy. Te płatności nie przechodzą przez bramkę online i nie są automatycznie weryfikowane)

{% hint style="warning" %}
Pamiętaj! Jeśli Twoje przedsiębiorstwo ma włączone „***Customers can change or cancel orders while an order cycle is open***” (w Enterprises -> Settings -> [Shop Preferences](/smaki-wsi-docs/basic-features/enterprise-profile/enterprise-settings.md#shop-preferences)), to jedynym zalecanym dostawcą płatności zgodnym z tą funkcją jest „Cash, EFTs, ...”.
{% endhint %}

* **Calculator:** Wybierz sposób naliczania opłat związanych z metodą płatności. Opłaty można ustawić na zero. Więcej informacji poniżej w [Opłaty metod płatności](#fee-calculators).

Po kliknięciu Create metoda płatności zostanie utworzona, a pojawią się pola do ustawienia opłat. Widoczne pola zależą od wybranego „Calculator”.

{% hint style="info" %}
Jeśli zmienisz pole „Calculator” dla opłat metody płatności, musisz najpierw zapisać zmiany (Update), aby pojawiły się nowe pola.
{% endhint %}

## Zintegrowani dostawcy płatności

Dla PayPal, MasterCard, Stripe i Pin Payments (tylko Australia) dodatkowe instrukcje poniżej.

{% tabs %}
{% tab title="Paypal" %}
Aby skonfigurować metodę płatności PayPal, potrzebujesz konta biznesowego/merchant w PayPal. Możesz je utworzyć [tutaj](https://www.paypal.com). Następnie skonfiguruj „API access” w PayPal, aby Smaki Wsi mogło połączyć klientów bezpośrednio z Twoim kontem PayPal.

1. Zaloguj się do PayPala.
2. Pod nazwą konta w prawym górnym rogu znajduje się menu rozwijane „Account Settings”.
3. Wybierz „Update” w sekcji API Access.
4. Wybierz „Manage API credentials” z opcji custom checkout experience.

Stąd uzyskasz API username, password i signature.

**W Smaki Wsi** upewnij się, że jesteś zalogowany jako użytkownik przedsiębiorstwa. Przejdź do Enterprise i utwórz Payment Method. Wybierz PayPal i uzupełnij dane z PayPala.

**Server:** Zmień pole „server” na „live” – wielkość liter ma znaczenie.

**Login:** Wpisz API Username.

**Password:** Wpisz API Password.

**Signature:** Wpisz API Signature.

**Solution:** Określa, czy użytkownik musi mieć konto PayPal, aby zapłacić.

Wpisz „Mark”, jeśli chcesz, aby użytkownicy musieli mieć konto PayPal, albo „Sole”, jeśli mogą zapłacić kartą bez konta PayPal. (Wielkość liter ma znaczenie.)

**Landing Page:** Wybierz stronę wyświetlaną klientom po przekierowaniu do PayPala.

Wpisz „Login”, aby kierować do logowania w PayPalu (jeśli wybrałeś „Mark”), albo „Billing”, aby pokazać formularz płatności kartą (jeśli wybrałeś „Sole”). (Wielkość liter ma znaczenie.)
{% endtab %}

{% tab title="MIGS" %}
MasterCard Internet Gateway Service (MIGS)

Konfigurację usługi należy przeprowadzić przez bank. Do tej pory testowano ją z Bendigo Bank.
{% endtab %}

{% tab title="Stripe" %}
[Stripe](https://stripe.com/au) to platforma płatności online podobna do PayPal. Umożliwia akceptowanie płatności kartą. Stripe jest globalny, ale dostępny tylko na wybranych instancjach Smaki Wsi. Skontaktuj się z [lokalnym zespołem Smaki Wsi](https://openfoodnetwork.org/ofn-local/), aby sprawdzić dostępność.

**Dlaczego Stripe?**

Stripe jest prosty w konfiguracji i w rozsądnej cenie. Opłaty Stripe różnią się w zależności od kraju: [Australia](https://stripe.com/au/pricing), [Kanada](https://stripe.com/ca/pricing), [Francja](https://stripe.com/fr/pricing), [UK](https://stripe.com/gb/pricing), [USA](https://stripe.com/us/pricing).

Stripe jest też wygodny dla klientów. W przeciwieństwie do PayPala, klient nie musi logować się do PayPala podczas checkoutu — po prostu podaje dane karty i finalizuje zamówienie.

Stripe to rekomendowana metoda płatności dla sklepów, które chcą korzystać z [**subskrypcji**](/smaki-wsi-docs/basic-features/subscriptions.md), ponieważ umożliwia automatyczne obciążanie karty klienta za zamówienia subskrypcyjne. PayPal, Pin i MIGS tego nie oferują.

**Konfiguracja**

**Połącz ze Stripe**

Zanim utworzysz metodę płatności Stripe, musisz połączyć się ze Stripe. Kliknij przycisk „Connect with Stripe”.

Zostaniesz przekierowany do formularza. Jeśli masz już konto Stripe, możesz się zalogować. Jeśli nie — wypełnij formularz, aby utworzyć konto.

Wymagane informacje obejmują: kraj, opis działalności, adres firmy, ABN, dane osobowe i konto bankowe (na które będą trafiać płatności).

**Utwórz nową metodę płatności**

Po połączeniu ze Stripe możesz utworzyć metodę płatności działającą z Twoim kontem.

Traktuj pola **Name**, **Description**, **Active** i **Tags** jak w każdej innej metodzie płatności.

**Provider:** wybierz Stripe.

Po wybraniu Stripe pojawią się „Provider Settings”.

**Stripe Account Owner:**

Wybierz przedsiębiorstwo, które ma podłączone konto Stripe.

Jeśli wybierzesz przedsiębiorstwo, które nie jest połączone ze Stripe (patrz wyżej), zobaczysz błąd poniżej. Kliknij „Connect One” lub wróć do zakładki Payment Methods i połącz Stripe.

**Płatności Stripe dla klientów**

Gdy klienci płacą Stripe podczas checkoutu, mogą zaznaczyć opcję zapisania danych karty na swoim koncie (jeśli są zalogowani).

Klient może też zapisać kartę w swoim koncie lub usunąć zapisane karty.

Przy kolejnych zakupach w sklepie Smaki Wsi z płatnością Stripe klienci będą mogli wybrać jedną z zapisanych kart.

**Podgląd i wypłata płatności przez Stripe**

Gdy klient płaci Stripe, środki (pomniejszone o opłaty Stripe) trafiają na Twoje konto Stripe. W zależności od ustawień, środki mogą być automatycznie wypłacane na konto bankowe cyklicznie.

**Pobieranie dodatkowej płatności**

Jeśli musisz pobrać dodatkową kwotę od klienta (np. zaległe saldo), możesz wystawić fakturę w Stripe. Klient otrzyma e-mail z prośbą o płatność kartą. To nie zostanie przekazane do Smaki Wsi, więc musisz ręcznie oznaczyć płatność jako otrzymaną.
{% endtab %}

{% tab title="Pin Payments" %}
Dla Pin Payments potrzebujesz tylko klucza API. Najpierw utwórz konto w Pin Payments. Możesz uzyskać zniżkę, zapisując się jako członek Smaki Wsi (<https://pinpayments.com/partners/openfoodnetwork/signup>).

**API Key:** Wpisz „Live Secret API Key” — znajdziesz go w koncie PinPayments (poniżej). Najpierw wybierz API Keys, następnie wygeneruj klucz i skopiuj „Live Secret API Key” do pola API key w Smaki Wsi.

**Server:** Wpisz „live” — wielkość liter ma znaczenie.
{% endtab %}
{% endtabs %}

## Opłaty metod płatności

Do metod płatności możesz dodać opłatę. Najczęściej służy to do przeniesienia kosztów prowizji bramki płatniczej na klienta. Na przykład możesz naliczać opłatę za płatność PayPal, aby pokryć prowizję PayPala.

{% hint style="danger" %}
Opłaty metod płatności NIE obejmują podatku (VAT).
{% endhint %}

### Kalkulatory opłat

**Flat Percent:** Opłata naliczana jako procent od łącznej kwoty zamówienia.

{% hint style="danger" %}
Wszystkie **opłaty procentowe** są liczone tylko od **kosztów produktów**.
{% endhint %}

{% hint style="warning" %}
Jeśli Twoja firma dodaje stałą procentową [opłatę przedsiębiorstwa](/smaki-wsi-docs/basic-features/shopfront/enterprise-fees.md) do wszystkich produktów, to aby uzyskać docelowy procent koszyka klienta w „Flat Percent”, użyj wzoru:

$$= (100 + Enterprise Fee)\*Desired Percent/100$$

np. dla opłaty przedsiębiorstwa 20% i chęci naliczenia 5% od koszyka klienta:

$$= (100 + 20) \*5/100 = 6$$
{% endhint %}

**Flat Rate (per order):** Opłata stała naliczana do wszystkich zamówień, niezależnie od ich wartości.

**Flexible Rate:** Kalkulator przydatny, gdy chcesz zachęcić klientów do większych zamówień — koszt płatności może zostać obniżony lub wyzerowany po osiągnięciu progu ilości.

* „First Item Cost”: opłata za pierwszy produkt.
* „Additional Item Cost”: opłata za kolejne produkty.
* „Max Items”: maksymalna liczba produktów, dla których naliczana jest opłata. Produkty powyżej tego limitu nie są już obciążane.

> Przykład: jeśli „First Item Cost” = 0,20 zł, „Additional Item Cost” = 0,10 zł i „Max Items” = 3, to klient, który kupi 5 produktów, zapłaci 0,40 zł (0,20 zł za pierwszy produkt, 0,10 zł za drugi i trzeci oraz 0,00 zł za czwarty i piąty).

**Flat Rate (per item):** Stała opłata naliczana do produktów sprzedawanych jako „items”. Nie dotyczy produktów sprzedawanych wagowo lub objętościowo (np. ryż na kg).

**Price Sack:** Elastyczna metoda opłat, która pozwala nagradzać klientów wydających powyżej „minimal amount” rabatem. Jeśli klient wyda mniej, płaci wyższą opłatę.

* Minimal Amount: jeśli wartość zamówienia jest poniżej tej kwoty, rabat nie jest stosowany. Jeśli powyżej — rabat obowiązuje przy checkout.
* „Normal Amount”: opłata stosowana przy zamówieniach poniżej „Minimal Amount”.
* „Discount Amount”: opłata stosowana przy zamówieniach powyżej „Minimal Amount”.

{% hint style="danger" %}
**Minimum Amount** to ***łączny koszt produktów*** w koszyku i nie obejmuje [opłat przedsiębiorstwa](/smaki-wsi-docs/basic-features/shopfront/enterprise-fees.md).
{% endhint %}

{% hint style="warning" %}
Na przykład, jeśli firma dodaje opłatę przedsiębiorstwa 20% do wszystkich produktów i chce ustawić próg między brakiem opłaty (Discount Amount = 0) a opłatą 0,50 zł (Normal Amount) na poziomie koszyka 30 zł, to Minimum Amount wynosi:

$$= 30 \* 100 /(100+20) = 25$$
{% endhint %}

{% hint style="info" %}
Bramki płatności często pobierają stałą opłatę za transakcję plus niewielki procent od kwoty. Oznacza to, że koszty dla huba lub sklepu są wyższe, gdy klient robi kilka małych zakupów, niż gdy robi jeden większy.\\

Kalkulatory Flexible Rate i Price Sack dla opłat metod płatności mogą pomóc to zrównoważyć.
{% endhint %}

## Zwroty

Wystawianie i obsługa zwrotów zależą od tego, jak klient pierwotnie opłacił zamówienie. Więcej informacji [tutaj](/smaki-wsi-docs/basic-features/orders/refunds-and-adjusting-payments.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://smaki-wsi.gitbook.io/smaki-wsi-docs/basic-features/shopfront/payment-methods.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.