Jednorazowy zakup

Skorzystaj z transakcji zakupu jednorazowego, jeśli chcesz natychmiast obciążyć kupującego opłatą.

Sprawdź poniżej dostępne środowiska, w których możesz wykonać żądanie POST między serwerami w celu wygenerowania transakcji.

Środowisko	URL	Metoda działania i punkt końcowy	Opis operacji
PROD	api.sibsgateway.com	POST version-id/{id}/card/purchase	Żąda płatności zarejestrowanej przy poprzedniej transakcji przy użyciu danych karty wprowadzonych przez klienta.
TEST	stargate-cer.qly.site[1\|2].sibs.pt	POST api/v1/payments/:transactionId/card/purchase	Żąda płatności zarejestrowanej przy poprzedniej transakcji przy użyciu danych karty wprowadzonych przez klienta.

Zanim dokonasz płatności

Upewnij się, że zamówienie zostało utworzone i przesłane
Żądanie wymaga nagłówka autoryzacji z podpisem transakcji zwróconym w odpowiedzi na utworzenie zamówienia.

Poniższy komunikat przedstawia jednorazowy zakup, w przypadku którego płatność jest realizowana natychmiastowo i nie są identyfikowane żadne dodatkowe usługi (3D Secure, Tokenizacja i Card OneClick) do połączenia.

Identyfikator ścieżki

ścieżka

Obowiązkowy

Opcjonalny element do sprawdzania statusu transakcji według identyfikatora transakcji.

Parametry nagłówka

Content-type

string

Mandatory

application/json

Authorization

string

Mandatory

Bearer Token. Based on OAuth2 authentication performed in a pre-step.

x-ibm-client-id

string

Mandatory

Token that identifies a client organization. It is provided during onboarding process and must be used in every call.

Parametry żądania

cardInfo

object

Mandatory

Object that defines the payment operation request fields.

PAN

string <= 40 characters

Optional

The Primary Account Number (credit card number).

secureCode

string <= 40 characters

Optional

The security code (CVV/CVC) associated with the credit card.

validationDate

ISODateTime

Mandatory

The expiration date of the credit card.

cardholderName

string

Mandatory

The name of the cardholder as it appears on the credit card.

createToken

boolean

Mandatory

A flag indicating whether to create a token for future use or not (true/false).

Oto przykład, jak dokonać jednorazowego zakupu:

Uruchom w Postmanie

{
 "cardInfo": {
 "PAN": "5236410030000927",
 "secureCode": "776",
 "validationDate": "2026-05-26T00:00:00.000Z",
 "cardholderName": "Jane Smith",
 "createToken": false
 }
}

Co dalej?

Zapoznaj się z innymi funkcjami płatności kartą, z których możesz skorzystać.

Płatność z preautoryzacją i późniejszym przejęciem, gdy pobierasz opłatę dopiero przy dostawie (całkowitej lub częściowej).
Autoryzacja płatności z uwierzytelnianiem 3D Secure (bezproblemowa lub kwestionowana).
Płatność w oparciu o tokenizację karty.
Płatność w oparciu o Kartę OneClick.

Po dokonaniu płatności otrzymasz odpowiedź zawierającą w wiadomości status płatności. Informuje, czy transakcja została zaakceptowana, odrzucona, oczekuje na ostateczny wynik lub wymaga dodatkowych działań.

Sukces: zakup został pomyślnie przetworzony, a klient został obciążony.
Odrzucony: zakup został odrzucony.
Oczekuje: Ostateczny wynik zakupu nie jest jeszcze znany. Będziesz musiał pytać o status tej transakcji, aż osiągnie ona stan ostateczny lub zdecydujesz się ją anulować.
Częściowy: zakup został częściowo zaakceptowany, ale do jego zakończenia wymagane są dodatkowe działania (np. uwierzytelnienie 3D-Secure). Element actionResponse zawiera instrukcje dotyczące dalszego postępowania.

Uzyskaj status płatności

Następnie, po przetworzeniu płatności, możesz sprawdzić status swojej transakcji, wysyłając żądanie GET.

Nagłówek HTTP autoryzacji jest ustawiony na token okaziciela, tak jak był używany podczas początkowej realizacji transakcji.

Uruchom w Postmanie

Adres URL żądania:

https://stargate-cer.qly.site1.sibs.pt/api/v1/payments/{transactionID}/status

Nagłówki żądań:

Autorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6I (...)
X-IBM-Client-Id: b4480347-9fc8-4790-b359-100a99c60ea3
Content-Type: application/json

Pomyślna odpowiedź techniczna składa się ze statusu HTTP-200 i returnStatus.statusCode=”000″.

Oto kilka przykładów możliwych kodów wyników:

Kod wyniku	statusMsg	Opis	Działanie
HTTP-200	Sukces	Pozytywna odpowiedź	nie dotyczy
HTTP-400	Zła prośba	Ładunek JSON nie jest zgodny z definicją API lub brakuje niektórych obowiązkowych nagłówków HTTP.	Sprawdź w API Market poprawną składnię.
HTTP-401	Nieautoryzowany	W przypadku Autoryzacji token okaziciela jest nieprawidłowy/wygasł lub nie jest powiązany z używanym terminalem.	Sprawdź w SIBS Backoffice w sekcji Poświadczenia, czy token jest ważny i w razie potrzeby utwórz nowy.
HTTP-403	Zabroniony	Identyfikator klienta ustawiony w nagłówku HTTP X-IBM-Client-Id jest nieprawidłowy lub nie posiada ważnej subskrypcji interfejsu API.	Sprawdź w SIBS Backoffice w SPG APP 2.0, czy ClientID jest poprawny. Jeśli problem będzie się powtarzał, skontaktuj się z pomocą techniczną SIBS Gateway w celu zresetowania ClientID.
HTTP-405	Niedozwolona metoda	Zastosowana metoda HTTP nie jest zgodna z żadną dostępną definicją API.	Sprawdź w API Market poprawną metodę HTTP.
HTTP-429	Zbyt dużo próśb	Przekroczono limit szybkości połączeń API.	Informacje na temat limitów stawek mających zastosowanie do API można znaleźć w API Market.
HTTP-500	Wewnętrzny błąd serwera	Wywołanie API nie powiodło się… i najprawdopodobniej jest to po naszej stronie.	Powinieneś ponowić operację, a jeśli problem będzie się powtarzał, skontaktuj się z pomocą techniczną SIBS Gateway w celu uzyskania pomocy.
HTTP-503	serwis niedostępny	Wywołanie API nie jest obecnie dostępne. Zwykle jesteśmy zawsze aktywni, ale podczas planowej konserwacji mogą wystąpić krótkie problemy z dostępnością.	Powinieneś poczekać i spróbować ponownie później.

Jednorazowy zakup

Zanim dokonasz płatności

Parametry nagłówka

Parametry żądania

Co dalej?

Uzyskaj status płatności

Adres URL żądania:

Nagłówki żądań:

On this page: