TailoredApps.Shared.Payments.Provider.CashBill

Integracja z CashBill — polskim operatorem płatności online obsługującym przelewy, karty i BLIK.

---

Instalacja

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

---

Rejestracja w DI

using TailoredApps.Shared.Payments.Provider.CashBill;

builder.Services
    .AddPayments()
    .RegisterCashBillProvider();

---

Konfiguracja appsettings.json

{
  "Payments": {
    "Providers": {
      "Cashbill": {
        "ShopId": "MY_SHOP_ID",
        "ShopSecretPhrase": "my_secret_phrase",
        "ServiceUrl": "https://pay.cashbill.eu",
        "ReturnUrl": "https://myapp.com/payment/return",
        "NegativeReturnUrl": "https://myapp.com/payment/failed"
      }
    }
  }
}

Opcja	Opis
ShopId	Identyfikator sklepu w CashBill
ShopSecretPhrase	Fraza sekretna do podpisywania żądań
ServiceUrl	URL API CashBill (domyślnie: https://pay.cashbill.eu)
ReturnUrl	URL powrotu po udanej płatności
NegativeReturnUrl	URL powrotu po nieudanej/anulowanej płatności

---

Obsługiwane kanały

CashBill zwraca dynamiczną listę kanałów pobraną z API dla danej waluty (PLN, EUR, USD itd.). Kanały obejmują przelew bankowy, karty, BLIK, e-portfele.

---

Webhook

CashBill wysyła powiadomienia GET/POST na NotifyUrl. Podpis weryfikowany przez SHA-1 + sekret.

---

🤖 AI Agent Prompt

## CashBill Provider — Instrukcja dla agenta AI

Provider key: "CashBill"

Sekcja konfiguracji: "Payments:Providers:Cashbill" (małe "b" w Cashbill!)

Wymagane pola: ShopId, ShopSecretPhrase, ServiceUrl, ReturnUrl, NegativeReturnUrl

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