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

# Dostawcy płatności

> Obsługiwani dostawcy, kanały i konfiguracja metod płatności.

Każdy sklep konfiguruje własne metody płatności (`POST /payment-methods`). Lista dostawców z minimalnymi kwotami i walutami jest dostępna publicznie przez `GET /payment-methods/providers`.

## Obsługiwani dostawcy

| Dostawca               | Nazwa adaptera (`name`)                                            |
| ---------------------- | ------------------------------------------------------------------ |
| Stripe                 | `stripe`                                                           |
| PayPal Business (REST) | `paypalRest`                                                       |
| imoje                  | `imojeTransfer`                                                    |
| ZEN                    | `zen`                                                              |
| Paymentic              | `paymentic`                                                        |
| Przelewy24             | `przelewy24`                                                       |
| CashBill               | `cashbillTransfer`                                                 |
| PayByLink              | `paybylinkTransfer`                                                |
| HotPay                 | `hotpayTransfer`, `hotpayPSC`, `hotpayDB`, `hotpayPR`, `hotpaySMS` |
| SimPay                 | `simpayOnline`                                                     |

Tabela opisuje adaptery, które ta wersja aplikacji potrafi utworzyć i bezpiecznie potwierdzić. Konkretne kanały widoczne dla kupującego zależą od adaptera, konfiguracji metody i usług aktywowanych w umowie sprzedawcy z operatorem; nie należy wnioskować ich wyłącznie z marki operatora.

<Warning>
  Nie konfiguruj `paypal`, `dotpayTransfer`, `dpayTransfer`, `psc`, `icehost`, `host2play` ani `skillhost`.
  Są to wpisy historyczne lub niekompletne integracje ukryte przez API, ponieważ nie mogą
  bezpiecznie potwierdzić płatności i automatycznie zrealizować zamówienia. Dotpay został
  połączony z Przelewy24 i nie jest już oferowany do nowych konfiguracji. `microSMS` nie
  jest obecnie implementowany. Dla PayPal użyj wyłącznie `paypalRest`.
</Warning>

## Jak wybrać operatora

Publiczna odpowiedź `GET /payment-methods/providers` jest źródłem prawdy o adapterach możliwych do skonfigurowania w tej wersji aplikacji. Nie jest jednak cennikiem ani obietnicą aktywacji konkretnego kanału.

<Warning>
  ItemShop nie publikuje stawek operatorów, ponieważ zmieniają się i często są ustalane indywidualnie. Przed uruchomieniem potwierdź w swojej umowie: dostępne kanały i waluty, prowizję i minimum, harmonogram wypłat, rezerwy/chargebacki, wymagany webhook oraz tryb sandbox. Każdą metodę przetestuj od checkoutu do podpisanego webhooka i dostawy pluginem.
</Warning>

## Konfiguracja metody

Każdy dostawca wymaga własnego zestawu kluczy w polu `config`. Przykład dla imoje:

```bash theme={null}
curl -X POST https://api.itemshop.dev/api/v2/payment-methods/<shopId> \
  -H "X-API-Key: <klucz-sklepu-z-payment-methods:manage>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "imojeTransfer",
    "displayName": "imoje",
    "shopId": "<shopId>",
    "config": {
      "MERCHANT_ID": "...",
      "SERVICE_ID": "...",
      "SERVICE_KEY": "...",
      "AUTH_TOKEN": "...",
      "SANDBOXMODE": true
    },
    "fees": { "percentage": 1.9, "minimumFee": 0.3 }
  }'
```

Wymagane klucze `config` dla danego dostawcy zwraca `GET /payment-methods/providers/{provider}/config`.

Wartości `fees` w przykładzie są wyłącznie przykładową konfiguracją księgową sklepu — nie są cennikiem imoje ani rekomendowaną stawką.

## Prowizje i kanały

Możesz ustawić prowizję globalną metody oraz nadpisania per kanał (`channelFees`). Prowizja jest odejmowana od kwoty brutto przy realizacji płatności. Zobacz [VAT i prowizje](/pl/guides/vat-and-fees).