# 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/_bundle/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: 
dc261d4f-31ef-4728-bfd6-97bbe2a5ef0a|e14f8074|transaction_db_payed|11.07|13.67|5.00|https://www.simpay.pl/complete|https://www.simpay.pl/failure|test|123123123|1|klucz

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

## 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 zwrotów dla transakcji

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

### Utworzenie zwrotu dla transakcji

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

### Pobieranie pojedynczego zwrotu w transakcji

 - [GET /payment/{serviceId}/transactions/{transactionId}/refunds/{refundId}](https://docs.simpay.pl/apis/payment/paymenttransactionrefundshow.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.

### Pobieranie listy subskrypcji

 - [GET /payment/{serviceId}/subscriptions](https://docs.simpay.pl/apis/payment/paymentsubscriptionindex.md): Zobacz https://docs.simpay.pl/payment/blik-recurrent po więcej informacji.

### Utworzenie subskrypcji

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

### Dokonaj Płatności Powtarzalnej BLIK

 - [POST /payment/{serviceId}/blik/subscriptions/{subscriptionId}/autopayment](https://docs.simpay.pl/apis/payment/paymentbliksubscriptionexecuteautopayment.md): Zobacz https://docs.simpay.pl/payment/blik-recurrent po więcej informacji.

### Pobieranie listy aliasów BLIK

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

### Usuwanie/wyrejestrowanie aliasu

 - [DELETE /payment/{serviceId}/blik/aliases](https://docs.simpay.pl/apis/payment/paymentblikaliasunregister.md): Zobacz https://docs.simpay.pl/payment/blik-recurrent po więcej informacji.

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

 - [POST paymentTransactionNotification](https://docs.simpay.pl/apis/payment/paymenttransactionnotification.md): # Zapoznaj się z linkiem poniżej. Tam uzyskasz wszystkie szczegóły:
https://docs.simpay.pl/notifications/payment