# simpay-api

[English version](/en/apis)

Version: 1.0.0

## Servers

```
https://api.simpay.pl
```

## Security

### bearerAuth

Type: http
Scheme: bearer

## Download OpenAPI description

[simpay-api](https://docs.simpay.pl/_spec/apis/index.yaml)

## SMS

### Lista usług

 - [GET /sms](https://docs.simpay.pl/apis/sms/smsservicelist.md): Pobieranie listy dostępnych usług SMS na koncie

### Pobieranie informacji o usłudze

 - [GET /sms/{serviceId}](https://docs.simpay.pl/apis/sms/smsserviceshow.md)

### Weryfikacja poprawności kodu

 - [POST /sms/{serviceId}](https://docs.simpay.pl/apis/sms/smsservicecheckcode.md)

### Pobieranie listy transakcji

 - [GET /sms/{serviceId}/transactions](https://docs.simpay.pl/apis/sms/smstransactionslist.md)

### Pobieranie informacji o transakcji

 - [GET /sms/{serviceId}/transactions/{transactionId}](https://docs.simpay.pl/apis/sms/smstransactionsshow.md)

### Pobieranie informacji o numerach dla usługi

 - [GET /sms/{serviceId}/numbers](https://docs.simpay.pl/apis/sms/smsservicenumbers.md)

### Pobieranie informacji o numerze dla usługi

 - [GET /sms/{serviceId}/numbers/{number}](https://docs.simpay.pl/apis/sms/smsservicenumber.md)

### Pobieranie wszystkich dostępnych numerów

 - [GET /sms/numbers](https://docs.simpay.pl/apis/sms/smsnumbers.md)

### Pobieranie numeru

 - [GET /sms/numbers/{number}](https://docs.simpay.pl/apis/sms/smsnumber.md)

## DirectBilling

### Pobieranie listy usług

 - [GET /directbilling](https://docs.simpay.pl/apis/directbilling/directbillinggetservices.md)

### Pobieranie informacji o usłudze

 - [GET /directbilling/{serviceId}](https://docs.simpay.pl/apis/directbilling/directbillingservice.md)

### Kalkulacja prowizji

 - [GET /directbilling/{serviceId}/calculate](https://docs.simpay.pl/apis/directbilling/directbillingservicecalculate.md)

### Pobieranie listy transakcji

 - [GET /directbilling/{serviceId}/transactions](https://docs.simpay.pl/apis/directbilling/directbillingtransactions.md)

### Generowanie transakcji

 - [POST /directbilling/{serviceId}/transactions](https://docs.simpay.pl/apis/directbilling/directbillingtransactioncreate.md)

### Pobieranie informacji o transakcji

 - [GET /directbilling/{serviceId}/transactions/{transactionId}](https://docs.simpay.pl/apis/directbilling/directbillingtransaction.md)

### Odbieranie informacji o transakcji DirectBilling

 - [POST directbillingTransactionNotification](https://docs.simpay.pl/apis/directbilling/directbillingtransactionnotification.md): # 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: 


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


## Płatności online

### Pobieranie listy usług

 - [GET /payment](https://docs.simpay.pl/apis/payment/paymentgetservices.md)

### Pobieranie szczegółów usługi

 - [GET /payment/{serviceId}](https://docs.simpay.pl/apis/payment/paymentgetservice.md)

### Pobieranie listy kanałów dla usługi

 - [GET /payment/{serviceId}/channels](https://docs.simpay.pl/apis/payment/paymentgetchannels.md)

### Pobieranie listy transakcji

 - [GET /payment/{serviceId}/transactions](https://docs.simpay.pl/apis/payment/paymentgettransactions.md)

### Generowanie transakcji

 - [POST /payment/{serviceId}/transactions](https://docs.simpay.pl/apis/payment/paymenttransactioncreate.md)

### Pobieranie szczegółów transakcji

 - [GET /payment/{serviceId}/transactions/{transactionId}](https://docs.simpay.pl/apis/payment/paymentgettransaction.md)

### Pobieranie listy walut dla usługi

 - [GET /payment/{serviceId}/currencies](https://docs.simpay.pl/apis/payment/paymentgetcurrencies.md)

### Podanie kodu BLIK do transakcji Level 0

 - [POST /payment/{serviceId}/blik/level0/{transactionId}](https://docs.simpay.pl/apis/payment/paymentbliklevel0.md): Zobacz https://docs.simpay.pl/payment/blik-level0 po więcej informacji.

### Odbieranie informacji o transakcji płatności online

 - [POST paymentTransactionNotification](https://docs.simpay.pl/apis/payment/paymenttransactionnotification.md): # 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 .