Przejdź do treści
Referencja API
/
/
Pobieranie listy zwrotów...

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 szczegółów transakcji

Żądanie

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

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

Odpowiedzi

Treśćapplication/json
successbooleanwymagany

Request status

Przykład: true
dataobjectwymagany
Przykład: {"id":"328bd42d-d08b-43f6-9463-869e5bd32b4","payer_transaction_id":"477YDX14","status":"transaction_paid","amount":{"value":7.55,"currency":"BRL","commission":0.12,"commission_currency":"EUR","original":{"value":5,"currency":"PLN","pln_rate":1}},"channel":"nest","control":null,"description":null,"redirect":{"success":null,"failure":null},"customer":{"name":null,"email":"kontakt@simpay.pl","ip":"192.168.0.1","country":"PL"},"billing":{"name":null,"surname":null,"street":null,"building":null,"flat":null,"city":null,"region":null,"postalCode":null,"country":null,"company":null},"shipping":{"name":null,"surname":null,"street":null,"building":null,"flat":null,"city":null,"region":null,"postalCode":null,"country":null,"company":null},"cart":null,"paid_at":"2023-12-07T05:21:50+01:00","expires_at":null,"created_at":"2023-12-07T05:20:30+01:00","updated_at":"2023-12-07T05:21:50+01:00"}
data.​idstring(uuid)(TransactionId)= 36 characters^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...wymagany

Id transakcji

data.​payer_transaction_idstringwymagany

Identyfikator transakcji udostępniony płacącemu

Przykład: "477YDX14"
data.​statusstring(paymentTransactionStatus)wymagany

Status transakcji

Enum"transaction_new""transaction_confirmed""transaction_generated""transaction_paid""transaction_failure""transaction_expired""transaction_canceled""transaction_refunded""transaction_fraud""transaction_fraud_possibility"
data.​amountobjectwymagany
Przykład: {"value":7.55,"currency":"BRL","commission":0.12,"commission_currency":"EUR","original":{"value":5,"currency":"PLN","pln_rate":1}}
data.​amount.​valuenumber(float)wymagany

Kwota płatności w walucie kupującego

Przykład: 7.55
data.​amount.​currencystring(ISO-4217)wymagany

Waluta kupującego

Przykład: "BRL"
data.​amount.​commissionnumber or null(float)wymagany

Kwota prowizji dla SimPay

Przykład: 0.12
data.​amount.​commission_currencystring(ISO-4217)wymagany

Waluta prowizji (PLN/EUR)

Przykład: "EUR"
data.​amount.​originalobject

Oryginalne kwoty zadeklarowane przy inicjacji

Przykład: {"value":5,"currency":"PLN","pln_rate":1}
data.​channelstring or nullwymagany
Przykład: "nest"
data.​controlstring or nullwymagany
data.​descriptionstring or nullwymagany
data.​redirectobjectwymagany
Przykład: {"success":null,"failure":null}
data.​redirect.​successstring or null(url)wymagany
data.​redirect.​failurestring or null(url)wymagany
data.​customerobjectwymagany
Przykład: {"name":null,"email":"kontakt@simpay.pl","ip":"192.168.0.1","country":"PL"}
data.​customer.​namestring or nullwymagany
data.​customer.​emailstring or null(email)wymagany
Przykład: "kontakt@simpay.pl"
data.​customer.​ipstring or null(ip)
Przykład: "192.168.0.1"
data.​customer.​countrystring or null(CountryCode)
Przykład: "PL"
data.​billingobject or null(paymentCustomerFull)wymagany
data.​billing.​namestring or null[ 5 .. 64 ] characterswymagany
data.​billing.​surnamestring or null<= 64 characterswymagany
data.​billing.​streetstring or null<= 64 characterswymagany
data.​billing.​buildingstring or null<= 16 characters
data.​billing.​flatstring or null<= 16 characters
data.​billing.​citystring or null<= 32 characterswymagany
data.​billing.​regionstring or null<= 32 characters
data.​billing.​postalCodestring or nullwymagany

Kod pocztowy, format zależny od pola country

data.​billing.​countrystring or null(ISO 3166-1 alpha-2)wymagany

Kraj

data.​billing.​companystring or null

Nazwa firmy

data.​shippingobject or null(paymentCustomerFull)wymagany
data.​shipping.​namestring or null[ 5 .. 64 ] characterswymagany
data.​shipping.​surnamestring or null<= 64 characterswymagany
data.​shipping.​streetstring or null<= 64 characterswymagany
data.​shipping.​buildingstring or null<= 16 characters
data.​shipping.​flatstring or null<= 16 characters
data.​shipping.​citystring or null<= 32 characterswymagany
data.​shipping.​regionstring or null<= 32 characters
data.​shipping.​postalCodestring or nullwymagany

Kod pocztowy, format zależny od pola country

data.​shipping.​countrystring or null(ISO 3166-1 alpha-2)wymagany

Kraj

data.​shipping.​companystring or null

Nazwa firmy

data.​cartArray of objects or null(paymentCartItem)wymagany
data.​cart[].​namestring[ 3 .. 64 ] characterswymagany

Nazwa produktu

data.​cart[].​quantitynumber(integer)>= 1wymagany

Ilość danego produktu

data.​cart[].​pricenumber(float)>= 0.01wymagany

Kwota jednego produktu

data.​cart[].​producerstring or null<= 64 characterswymagany

Marka producneta produktu

data.​cart[].​categorystring or null<= 64 characterswymagany

Kategoria produktu

data.​cart[].​codestring or null<= 64 characterswymagany

Kod produktu

data.​paid_atstring(date-time)(DateTime)wymagany

Data utworzenia w formacie: ISO 8601

data.​expires_atstring(date-time)(DateTime)wymagany

Data utworzenia w formacie: ISO 8601

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

Odpowiedź
application/json
{
  "success": true,
  "data": {
    "id": "328bd42d-d08b-43f6-9463-869e5bd32b4",
    "payer_transaction_id": "477YDX14",
    "status": "transaction_paid",
    "amount": { … },
    "channel": "nest",
    "control": null,
    "description": null,
    "redirect": { … },
    "customer": { … },
    "billing": { … },
    "shipping": { … },
    "cart": null,
    "paid_at": "2023-12-07T05:21:50+01:00",
    "expires_at": null,
    "created_at": "2023-12-07T05:20:30+01:00",
    "updated_at": "2023-12-07T05:21:50+01:00"
  }
}

Pobieranie listy zwrotów dla transakcji

Żądanie

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

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

Odpowiedzi

Treśćapplication/json
successbooleanwymagany

Request status

Przykład: true
dataArray of objectswymagany
Przykład: [{"id":"019483a5-885e-70f7-9b5b-94387a6690da","status":"refund_completed","amount":1,"currency":"PLN","wallet_amount":1,"wallet_currency":"PLN","created_at":"2025-01-20T13:17:31+01:00","updated_at":"2025-01-20T13:17:59+01:00"}]
data[].​idstring(uuid)(RefundId)= 36 characters^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...wymagany

Id zwrotu

data[].​statusstring(paymentTransactionRefundStatus)wymagany

Status zwrotu

Enum"refund_new""refund_pending""refund_completed""refund_rejected""refund_failed"
data[].​amountnumber(float)wymagany

Kwota zwrotu w walucie płacącego

data[].​currencystring= 3 characterswymagany

Waluta płacącego

data[].​wallet_amountnumber(float)wymagany

Kwota zwrotu pobrana z portfela

data[].​wallet_currencystring= 3 characterswymagany

Waluta portfela

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

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

Utworzenie zwrotu dla transakcji

Żądanie

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

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

Odpowiedzi

Treśćapplication/json
successbooleanwymagany

Request status

Przykład: true
dataobjectwymagany
Przykład: {"refund_id":"019483a5-885e-70f7-9b5b-94387a6690da"}
data.​refund_idstring(uuid)(RefundId)= 36 characters^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...wymagany

Id zwrotu

Odpowiedź
application/json
{
  "success": true,
  "data": {
    "refund_id": "019483a5-885e-70f7-9b5b-94387a6690da"
  }
}
© 2025 Payments Solution Sp. z o.o. - All rights reserved.