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.

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.

​

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.

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.

​

Konfiguracja metody

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

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.