# Odbieranie informacji o transakcji płatności online

# PONIŻSZY TEKST PRZEDSTAWIA IPN V1, KTÓRE ZOSTANIE USUNIĘTE 1 LUTEGO 2026. ZOBACZ IPN V2:
https://docs.simpay.pl/notifications/payment

# Sygnatura

## Obliczanie sygnatury przy odbieraniu notyfikacji
Sygnature generujemy za pomocą zestawienia ze sobą wszystkich odebranych parametrów (oprócz signature) do API w kolejności z dostępnej powyżej tabli oddzielając je seperatorem | i dodając na końcu klucz dostępny w panelu klienta w usłudze.
Hashowanie musi odbyć się za pomocą sha256.
Przykład dla opłaconej transakcji przy pomocy zadeklarowanej waluty: 


Przykład dla opłaconej transakcji za pomocą innej waluty niż zadeklarowanej: 


Notyfikacja wysyłana jest metodą  i wymaga od Ciebie odpowiedzi w body  oraz Http Code .


Endpoint: POST paymentTransactionNotification
Version: 1.0.0

## Request fields (application/json):

  - `id` (string, required)
    Id transakcji

  - `service_id` (string, required)
    Id usługi

  - `status` (string, required)
    Status transakcji
    Enum: "transaction_new", "transaction_confirmed", "transaction_generated", "transaction_paid", "transaction_failure", "transaction_expired", "transaction_canceled", "transaction_refunded"

  - `amount` (object, required)
    Obiekt rozliczeniowy
    Example: {"value":10,"currency":"PLN","commission":9.9}

  - `amount.value` (number, required)
    Kwota transakcji (w opłaconej walucie)
    Example: 10

  - `amount.currency` (string, required)
    Waluta transakcji, którą zapłacił kupujący
    Example: "PLN"

  - `amount.commission` (number, required)
    Kwota prowizji pobranej przez simpay (w PLN lub EUR)
    Example: 9.9

  - `control` (string)
    Pole do wykorzystania przez partnera
    Example: "88643ada8857f25a1f391395f922f7db"

  - `channel` (string, required)
    Kanał płatności
    Example: "blik"

  - `environment` (string, required)
    Enum: "production", "test"

  - `originalAmount` (object)
    Informacje o oryginalnej walucie i kwocie. Obiekt wysyłany tylko wtedy, gdy płacący zmienił walutę na bramce płatności.

  - `originalAmount.value` (number, required)
    Kwota transakcji w walucie, która była wysyłana przy generowaniu.

  - `originalAmount.currency` (string, required)
    Waluta transakcji, która była wysyłana przy generowaniu

  - `originalAmount.rate` (number, required)
    Kurs waluty według kursów NBP z okresu generowania transakcji.

  - `signature` (string, required)
    Sygnatura notyfikacji. Wyliczanie sygnatury pokazane wyżej.
Partner ma obowiązek weryfikować sygnaturę przy otrzymaniu powiadomienia, można też wykonać request do endpointu [Pobieranie szczegółów transakcji](#tag/Payment/operation/paymentGetTransaction)
    Example: "a3116cf4f1e960223c2cc3088bf387278b6675255209bdeaf96a2f316a2fadc1"