Przejdź do treści
Referencja API
/
/
Podanie kodu BLIK do tran...

simpay-api (1.0.0)

English version

Pobierz opis OpenAPI
index.json
index.yaml
Przegląd
URL

https://simpay.pl/kontakt

Support

kontakt@simpay.pl

Warunki świadczenia usług

Języki
Serwery
Mock server

https://docs.simpay.pl/_mock/apis/

https://api.simpay.pl/

SMS

Operacje

DirectBilling

OperacjeWebhooki

Płatności online

Operacje

Pobieranie listy walut dla usługi

Żądanie

Bezpieczeństwo
bearerAuth
Ścieżka
serviceIdstring(ServiceId)= 8 characters^[0-9a-f]{8}$wymagany

Id usługi

curl -i -X GET \
  'https://docs.simpay.pl/_mock/apis/payment/{serviceId}/currencies' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Odpowiedzi

Treśćapplication/json
successbooleanwymagany

Request status

Przykład: true
dataArray of objectswymagany
Przykład: [{"iso":"PLN","pln_rate":"1.0000000000","nbp_table":"A","prefix":null,"suffix":" zł","updated_at":"2025-05-10T13:04:32+02:00"},{"iso":"EUR","pln_rate":"4.3238000000","nbp_table":"A","prefix":"€","suffix":null,"updated_at":"2025-05-10T13:04:32+02:00"},{"iso":"ARS","pln_rate":"0.0034150000","nbp_table":"B","prefix":"ARS$","suffix":null,"updated_at":"2025-05-10T13:04:32+02:00"}]
data[].​isostringwymagany

Kod ISO waluty (PLN, USD, EUR, BRL etc.)

data[].​pln_ratestringwymagany

Kurs waluty według kursu NBP

data[].​nbp_tablestringwymagany

Tabela do kursu NBP

data[].​prefixstring or null

Prefiks waluty

data[].​suffixstring or null

Sufiks waluty

data[].​updated_atstring(date)wymagany

Data ostatniej aktualizacji waluty

Odpowiedź
application/json
{
  "success": true,
  "data": [
    { … },
    { … },
    { … }
  ]
}

Podanie kodu BLIK do transakcji Level 0

Żądanie

Zobacz https://docs.simpay.pl/payment/blik-level0 po więcej informacji.

Bezpieczeństwo
bearerAuth
Ścieżka
serviceIdstring(ServiceId)= 8 characters^[0-9a-f]{8}$wymagany

Id usługi

transactionIdstring(uuid)(TransactionId)= 36 characters^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...wymagany

Id transakcji

Treśćapplication/json
ticketobjectwymagany

Obiekt kodu BLIK

Przykład: {"T6":"123123"}
ticket.​T6string= 6 characterswymagany

6-cyfrowy Kod BLIK

Przykład: "123123"
curl -i -X POST \
  'https://docs.simpay.pl/_mock/apis/payment/{serviceId}/blik/level0/{transactionId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "ticket": {
      "T6": "123123"
    }
  }'

Odpowiedzi

Payment confirmation sent to Payers Banking App

Odpowiedź
Brak zawartości

Pobieranie listy subskrypcji

Żądanie

Zobacz https://docs.simpay.pl/payment/blik-recurrent po więcej informacji.

Bezpieczeństwo
bearerAuth
Ścieżka
serviceIdstring(ServiceId)= 8 characters^[0-9a-f]{8}$wymagany

Id usługi

Zapytanie
filter[status]string(subscriptionStatus)

Status subskrypcji

Enum"subscription_pending""subscription_active""subscription_cancelled""subscription_expired""subscription_finished""subscription_fraudulent"
Przykład: filter[status]=subscription_active
filter[mode]string(subscriptionMode)

Tryb subskrypcji

Enum"BLIK""CARD"
Przykład: filter[mode]=BLIK
filter[uuid]string(uuid)(SubscriptionId)= 36 characters^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...

Id subskrypcji

Przykład: filter[uuid]=019970c6-3d3e-708c-9313-5f89e251e2c0
pageinteger>= 1

Numer strony

Domyślny 1
Przykład: page=1
perPageinteger[ 1 .. 50 ]

Ile wyników na stronę pokazać

Domyślny 20
Przykład: perPage=20
sortstring

Pokazuj w kolejności od (-created_at = najnowszych, created_at = najstarszych)

Enum"-created_at""created_at"
curl -i -X GET \
  'https://docs.simpay.pl/_mock/apis/payment/{serviceId}/subscriptions?filter%5Bstatus%5D=subscription_active&filter%5Bmode%5D=BLIK&filter%5Buuid%5D=019970c6-3d3e-708c-9313-5f89e251e2c0&page=1&perPage=20&sort=-created_at' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Odpowiedzi

Treśćapplication/json
successbooleanwymagany

Request status

Przykład: true
dataArray of objectswymagany
Przykład: [{"id":"019970c6-3d3e-708c-9313-5f89e251e2c0","status":"subscription_active","mode":"BLIK","blik":{"model":"O","alias":{"id":"019970c6-3ce8-71e7-8214-20fd635532fb","type":"PAYID","value":"AABBCC","label":"Płatność za pakiet premium","blik_key":null,"status":"alias_active","expires_at":"2035-07-15T00:00:00+02:00","created_at":"2025-09-22T11:34:23+02:00","updated_at":"2025-09-22T11:34:32+02:00"}},"frequency":null,"initiation_date":null,"total_amount_limit":null,"total_transactions_limit":null,"cancelled":null,"created_at":"2025-09-22T11:34:24+02:00","updated_at":"2025-09-22T11:34:32+02:00"},{"id":"0198a54d-05e1-72b8-b835-f2258609bb52","status":"subscription_cancelled","mode":"BLIK","blik":{"model":"O","alias":{"id":"0198a54d-05d9-7177-9ac6-5d9831bc988d","type":"PAYID","value":"CCBBAA","label":"Subskrypcja za muzykę","blik_key":null,"status":"alias_unregistered","expires_at":null,"created_at":"2025-08-13T23:19:05+02:00","updated_at":"2025-08-13T23:19:16+02:00"}},"frequency":"1M","initiation_date":"2025-08-13T23:15:13+02:00","total_amount_limit":null,"total_transactions_limit":null,"cancelled":{"by":"merchant","reason":"Rezygnacja przez użytkownika"},"created_at":"2025-08-13T23:19:05+02:00","updated_at":"2025-08-13T23:19:16+02:00"}]
data[].​idstring(uuid)(SubscriptionId)= 36 characters^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...wymagany

Id subskrypcji

data[].​statusstring(subscriptionStatus)wymagany

Status subskrypcji

Enum"subscription_pending""subscription_active""subscription_cancelled""subscription_expired""subscription_finished""subscription_fraudulent"
data[].​modestring(subscriptionMode)wymagany

Tryb subskrypcji

Enum"BLIK""CARD"
data[].​blikobject
data[].​frequencystring or null

Częstotliwość subskrypcji

Przykład: "1M"
data[].​initiation_datestring or null

Data pierwszej możliwej Płatności Powtarzalnej

Przykład: "2025-08-13T23:15:13+02:00"
data[].​total_amount_limitnumber or null

Całkowita kwota, która jest dla tej Płatności Powtarzalnej

Przykład: 4000
data[].​total_transactions_limitinteger or null

Całkowita ilość możliwych transakcji dla Płatności Powtarzalnej

Przykład: 12
data[].​cancelledobject or null
data[].​created_atstring(date-time)(DateTime)wymagany

Data utworzenia w formacie: ISO 8601

data[].​updated_atstring(date-time)(DateTime)wymagany

Data utworzenia w formacie: ISO 8601

paginationobject(Pagination)wymagany
pagination.​totalintegerwymagany

Liczba wszystkich rekordów

Przykład: 1
pagination.​countintegerwymagany

Liczba rekordów na danej stronie

Przykład: 1
pagination.​per_pageintegerwymagany

Maksymalna ilość rekordów na strone

Przykład: 15
pagination.​current_pageintegerwymagany

Aktualna strona

Przykład: 1
pagination.​total_pagesintegerwymagany

Ilość stron

Przykład: 1
pagination.​linksobjectwymagany

Adresy URL do stron

pagination.​links.​next_pagestring or null(url)wymagany

Adres URL do następnej strony

Przykład: null
pagination.​links.​prev_pagestring or null(url)wymagany

Adres URL do poprzedniej strony

Przykład: null
Odpowiedź
application/json
{
  "success": true,
  "data": [
    { … },
    { … }
  ],
  "pagination": {
    "total": 2,
    "count": 2,
    "per_page": 20,
    "current_page": 1,
    "total_pages": 1,
    "links": { … }
  }
}
© 2025 Payments Solution Sp. z o.o. - All rights reserved.