API Reference

/

simpay-api (1.0.0)

English version

Download OpenAPI description

Overview

URL

https://simpay.pl/kontakt

Support

kontakt@simpay.pl

Terms of Service

Servers

Mock server

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

https://api.simpay.pl/

SMS

Operations

Lista usług

Request

Pobieranie listy dostępnych usług SMS na koncie

Security

bearerAuth

curl -i -X GET \
  https://docs.simpay.pl/_mock/apis/sms \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Bodyapplication/json

successbooleanrequired

Request status

Example: true

dataArray of objects(smsServiceList)required

Example: [{"id":"d151e4f9","type":"ONE_TIME_CODE","status":"service_active","name":"TEST","prefix":"SIM","suffix":"TESTSIMPAY","adult":false,"created_at":"2021-11-08T18:18:53+01:00"}]

data[].idstring(ServiceId)= 8 characters^[0-9a-f]{8}$required

Id usługi

data[].typestring(ServiceType)required

Typ usługi SMS

Enum"ONE_TIME_CODE""CODE_PACK""API_URL"

data[].statusstring(ServiceStatus)required

Status usługi

Enum"service_new""service_active""service_blocked""service_rejected""service_verify""service_ongoing_registration"

data[].namestringrequired

Nazwa usługi

data[].prefixstringrequired

Prefix usługi, czyli pierwszy człon treści SMS np. SIM

data[].suffixstringrequired

Suffix usługi, czyli drugi człon treści SMS

data[].descriptionstring

Opis usługi

data[].adultbooleanrequired

Informacja o tym czy usługa jest 18+

data[].created_atstring(date-time)(DateTime)required

Data utworzenia w formacie: ISO 8601

paginationobject(Pagination)required

pagination.totalintegerrequired

Liczba wszystkich rekordów

Example: 1

pagination.countintegerrequired

Liczba rekordów na danej stronie

Example: 1

pagination.per_pageintegerrequired

Maksymalna ilość rekordów na strone

Example: 15

pagination.current_pageintegerrequired

Aktualna strona

Example: 1

pagination.total_pagesintegerrequired

Ilość stron

Example: 1

pagination.linksobjectrequired

Adresy URL do stron

pagination.links.next_pagestring or null(url)required

Adres URL do następnej strony

Example: null

pagination.links.prev_pagestring or null(url)required

Adres URL do poprzedniej strony

Example: null

Response

application/json

{
  "success": true,
  "data": [
    { … }
  ],
  "pagination": {
    "total": 1,
    "count": 1,
    "per_page": 15,
    "current_page": 1,
    "total_pages": 1,
    "links": { … }
  }
}

Pobieranie informacji o usłudze

Request

Security

bearerAuth

Path

serviceIdstring(ServiceId)= 8 characters^[0-9a-f]{8}$required

Id usługi

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

Responses

Bodyapplication/json

successbooleanrequired

Request status

Example: true

dataArray of objects(smsService)required

Example: {"id":"d151e4f9","type":"ONE_TIME_CODE","status":"service_active","name":"TEST","prefix":"SIM","suffix":"TESTSIMPAY","adult":false,"numbers":[7055,7155,7255],"created_at":"2021-11-08T18:18:53+01:00"}

data[].idstring(ServiceId)= 8 characters^[0-9a-f]{8}$required

Id usługi

data[].typestring(ServiceType)required

Typ usługi SMS

Enum"ONE_TIME_CODE""CODE_PACK""API_URL"

data[].statusstring(ServiceStatus)required

Status usługi

Enum"service_new""service_active""service_blocked""service_rejected""service_verify""service_ongoing_registration"

data[].namestringrequired

Nazwa usługi

data[].prefixstringrequired

Prefix usługi, czyli pierwszy człon treści SMS np. SIM

data[].suffixstringrequired

Suffix usługi, czyli drugi człon treści SMS

data[].descriptionstring

Opis usługi

data[].adultbooleanrequired

Informacja o tym czy usługa jest 18+

data[].numbersArray of integers(ServicesNumbers)required

Items Enum705571557255735574557555763677464784647936

data[].created_atstring(date-time)(DateTime)required

Data utworzenia w formacie: ISO 8601

Response

application/json

{
  "success": true,
  "data": {
    "id": "d151e4f9",
    "type": "ONE_TIME_CODE",
    "status": "service_active",
    "name": "TEST",
    "prefix": "SIM",
    "suffix": "TESTSIMPAY",
    "adult": false,
    "numbers": [ … ],
    "created_at": "2021-11-08T18:18:53+01:00"
  }
}

Weryfikacja poprawności kodu

Request

Security

bearerAuth

Path

serviceIdstring(ServiceId)= 8 characters^[0-9a-f]{8}$required

Id usługi

Bodyapplication/jsonrequired

One of:

codestring(SmsCode)[ 6 .. 6 ]^[A-Z0-9]{6}$required

Kod z wiadomości SMS

numberinteger(ServiceNumbers)required

Numer do wysyłki wiadomości SMS

Enum705571557255735574557555763677464784647936

curl -i -X POST \
  'https://docs.simpay.pl/_mock/apis/sms/{serviceId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "code": "AB12D6",
    "number": 7055
  }'

Responses

Bodyapplication/json

One of:

successbooleanrequired

Request status

Example: true

dataArray of objects(smsServiceCheckCodeUsedData)required

Example: {"used":true,"code":"ABC1D6","test":true,"from":"48123123123","number":7055,"value":0.5,"send_at":"2021-11-14T19:00:36+01:00"}

data[].usedbooleanrequired

Informacja czy kod został wykorzystany

data[].codestringrequired

Kod z SMS

data[].testbooleanrequired

Informacja czy kod testowy

data[].fromintegerrequired

Numer z jakiego wysłano SMS

data[].numberinteger(ServiceNumbers)required

Numer do wysyłki wiadomości SMS

Enum705571557255735574557555763677464784647936

data[].valuenumber(float)required

Kwota netto SMSa

data[].used_atstring(date-time)(DateTime)required

Data utworzenia w formacie: ISO 8601

Response

application/json

{
  "success": true,
  "data": {
    "used": true,
    "code": "ABC1D6",
    "test": true,
    "from": "48123123123",
    "number": 7055,
    "value": 0.5,
    "send_at": "2021-11-14T19:00:36+01:00"
  }
}

Pobieranie listy transakcji

Request

Security

bearerAuth

Path

serviceIdstring(ServiceId)= 8 characters^[0-9a-f]{8}$required

Id usługi

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

Responses

Bodyapplication/json

successbooleanrequired

Request status

Example: true

dataArray of objects(ServiceTransaction)required

Example: [{"id":1,"from":48123123123,"code":"ABC1D6","used":false,"send_number":7055,"value":0.5,"send_at":"2021-11-14T19:00:36+01:00"}]

data[].idintegerrequired

Id transakcji SMS

data[].fromintegerrequired

Numer z jakiego wysłano SMS

data[].codestringrequired

Kod z SMS

data[].usedbooleanrequired

Informacja czy kod został wykorzystany

data[].send_numberinteger(ServiceNumbers)required

Numer do wysyłki wiadomości SMS

Enum705571557255735574557555763677464784647936

data[].valuenumber(float)required

Kwota netto SMSa

data[].send_atstring(date-time)(DateTime)required

Data utworzenia w formacie: ISO 8601

paginationobject(Pagination)required

pagination.totalintegerrequired

Liczba wszystkich rekordów

Example: 1

pagination.countintegerrequired

Liczba rekordów na danej stronie

Example: 1

pagination.per_pageintegerrequired

Maksymalna ilość rekordów na strone

Example: 15

pagination.current_pageintegerrequired

Aktualna strona

Example: 1

pagination.total_pagesintegerrequired

Ilość stron

Example: 1

pagination.linksobjectrequired

Adresy URL do stron

pagination.links.next_pagestring or null(url)required

Adres URL do następnej strony

Example: null

pagination.links.prev_pagestring or null(url)required

Adres URL do poprzedniej strony

Example: null

Response

application/json

{
  "success": true,
  "data": [
    { … }
  ],
  "pagination": {
    "total": 1,
    "count": 1,
    "per_page": 15,
    "current_page": 1,
    "total_pages": 1,
    "links": { … }
  }
}

Pobieranie informacji o transakcji

Request

Security

bearerAuth

Path

serviceIdstring(ServiceId)= 8 characters^[0-9a-f]{8}$required

Id usługi

transactionIdintegerrequired

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

Responses

Bodyapplication/json

successbooleanrequired

Request status

Example: true

dataobject(ServiceTransaction)required

data.idintegerrequired

Id transakcji SMS

data.fromintegerrequired

Numer z jakiego wysłano SMS

data.codestringrequired

Kod z SMS

data.usedbooleanrequired

Informacja czy kod został wykorzystany

data.send_numberinteger(ServiceNumbers)required

Numer do wysyłki wiadomości SMS

Enum705571557255735574557555763677464784647936

data.valuenumber(float)required

Kwota netto SMSa

data.send_atstring(date-time)(DateTime)required

Data utworzenia w formacie: ISO 8601

Response

application/json

{
  "success": true,
  "data": {
    "id": 1,
    "from": 48123123123,
    "code": "ABC1D6",
    "used": false,
    "send_number": 7055,
    "value": 0.5,
    "send_at": "2021-11-14T19:00:36+01:00"
  }
}

Pobieranie informacji o numerach dla usługi

Request

Security

bearerAuth

Path

serviceIdstring(ServiceId)= 8 characters^[0-9a-f]{8}$required

Id usługi

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

Responses

Bodyapplication/json

successbooleanrequired

Request status

Example: true

dataArray of objects(smsNumber)required

Example: [{"number":7055,"value":2,"value_net":2.46,"adult":false}]

data[].numberinteger(ServiceNumbers)required

Numer do wysyłki wiadomości SMS

Enum705571557255735574557555763677464784647936

data[].valuenumber(float)required

data[].value_netnumber(float)required

data[].adultbooleanrequired

paginationobject(Pagination)required

pagination.totalintegerrequired

Liczba wszystkich rekordów

Example: 1

pagination.countintegerrequired

Liczba rekordów na danej stronie

Example: 1

pagination.per_pageintegerrequired

Maksymalna ilość rekordów na strone

Example: 15

pagination.current_pageintegerrequired

Aktualna strona

Example: 1

pagination.total_pagesintegerrequired

Ilość stron

Example: 1

pagination.linksobjectrequired

Adresy URL do stron

pagination.links.next_pagestring or null(url)required

Adres URL do następnej strony

Example: null

pagination.links.prev_pagestring or null(url)required

Adres URL do poprzedniej strony

Example: null

Response

application/json

{
  "success": true,
  "data": [
    { … }
  ],
  "pagination": {
    "total": 1,
    "count": 1,
    "per_page": 15,
    "current_page": 1,
    "total_pages": 1,
    "links": { … }
  }
}

Pobieranie informacji o numerze dla usługi

Request

Security

bearerAuth

Path

serviceIdstring(ServiceId)= 8 characters^[0-9a-f]{8}$required

Id usługi

numberintegerrequired

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

Responses

Bodyapplication/json

successbooleanrequired

Example: true

dataobject(smsNumber)required

data.numberinteger(ServiceNumbers)required

Numer do wysyłki wiadomości SMS

Enum705571557255735574557555763677464784647936

data.valuenumber(float)required

data.value_netnumber(float)required

data.adultbooleanrequired

Response

application/json

{
  "success": true,
  "data": {
    "number": 7055,
    "value": 2,
    "value_net": 2.46,
    "adult": false
  }
}

Pobieranie wszystkich dostępnych numerów

Request

Security

bearerAuth

curl -i -X GET \
  https://docs.simpay.pl/_mock/apis/sms/numbers \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Bodyapplication/json

successbooleanrequired

Request status

Example: true

dataArray of objects(smsNumber)required

Example: [{"number":7055,"value":2,"value_net":2.46,"adult":false}]

data[].numberinteger(ServiceNumbers)required

Numer do wysyłki wiadomości SMS

Enum705571557255735574557555763677464784647936

data[].valuenumber(float)required

data[].value_netnumber(float)required

data[].adultbooleanrequired

paginationobject(Pagination)required

pagination.totalintegerrequired

Liczba wszystkich rekordów

Example: 1

pagination.countintegerrequired

Liczba rekordów na danej stronie

Example: 1

pagination.per_pageintegerrequired

Maksymalna ilość rekordów na strone

Example: 15

pagination.current_pageintegerrequired

Aktualna strona

Example: 1

pagination.total_pagesintegerrequired

Ilość stron

Example: 1

pagination.linksobjectrequired

Adresy URL do stron

pagination.links.next_pagestring or null(url)required

Adres URL do następnej strony

Example: null

pagination.links.prev_pagestring or null(url)required

Adres URL do poprzedniej strony

Example: null

Response

application/json

{
  "success": true,
  "data": [
    { … }
  ],
  "pagination": {
    "total": 1,
    "count": 1,
    "per_page": 15,
    "current_page": 1,
    "total_pages": 1,
    "links": { … }
  }
}

Pobieranie numeru

Request

Security

bearerAuth

Path

numberintegerrequired

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

Responses

Bodyapplication/json

successbooleanrequired

Example: true

dataobject(smsNumber)required

data.numberinteger(ServiceNumbers)required

Numer do wysyłki wiadomości SMS

Enum705571557255735574557555763677464784647936

data.valuenumber(float)required

data.value_netnumber(float)required

data.adultbooleanrequired

Response

application/json

{
  "success": true,
  "data": {
    "number": 7055,
    "value": 2,
    "value_net": 2.46,
    "adult": false
  }
}

DirectBilling

OperationsWebhooks

Płatności online

OperationsWebhooks