TailoredApps.Shared.Payments.Provider.Przelewy24

Integracja z Przelewy24 — jednym z najpopularniejszych polskich operatorów płatności online obsługującym ponad 170 banków i BLIK.

---

Instalacja

dotnet add package TailoredApps.Shared.Payments.Provider.Przelewy24

---

Rejestracja w DI

using TailoredApps.Shared.Payments.Provider.Przelewy24;

builder.Services
    .AddPayments()
    .RegisterPrzelewy24Provider();

---

Konfiguracja appsettings.json

{
  "Payments": {
    "Providers": {
      "Przelewy24": {
        "MerchantId": 12345,
        "PosId": 12345,
        "ApiKey": "your-api-key",
        "CrcKey": "your-crc-key",
        "ServiceUrl": "https://secure.przelewy24.pl",
        "ReturnUrl": "https://myapp.com/payment/return",
        "NotifyUrl": "https://myapp.com/webhooks/przelewy24"
      }
    }
  }
}

Opcja	Opis
MerchantId	Identyfikator sprzedawcy w Przelewy24
PosId	Identyfikator punktu sprzedaży (zazwyczaj = MerchantId)
ApiKey	Klucz API do autoryzacji żądań
CrcKey	Klucz CRC do generowania podpisów transakcji
ServiceUrl	URL API (sandbox: https://sandbox.przelewy24.pl)
ReturnUrl	URL powrotu po płatności
NotifyUrl	URL do powiadomień o transakcjach (webhook)

---

Obsługiwane kanały

Przelewy24 obsługuje PLN i EUR przez ponad 170 kanałów płatności (banki, BLIK, karty). Lista kanałów pobierana z API Przelewy24.

---

Webhook

Przelewy24 weryfikuje płatność przez endpoint /transaction/verify. Podpis transakcji oparty na SHA-384 z kluczem CRC.

---

🤖 AI Agent Prompt

## Przelewy24 Provider — Instrukcja dla agenta AI

Provider key: "Przelewy24"

Sekcja konfiguracji: "Payments:Providers:Przelewy24"

Wymagane pola: MerchantId, PosId, ApiKey, CrcKey, ReturnUrl, NotifyUrl

Kwota: grosze (int) — biblioteka konwertuje automatycznie

Sandbox: ServiceUrl = "https://sandbox.przelewy24.pl"

Rejestracja: builder.Services.AddPayments().RegisterPrzelewy24Provider();