Skip to content

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.

ŚrodowiskoURLMetoda działania i punkt końcowyOpis operacji
PRODapi.sibsgateway.comPOST version-id/{id}/card/purchaseŻąda płatności zarejestrowanej przy poprzedniej transakcji przy użyciu danych karty wprowadzonych przez klienta.
TESTstargate-cer.qly.site[1|2].sibs.ptPOST
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

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 Karta OneClick) do połączenia.

Identyfikator ścieżki

ścieżka

Obowiązkowy

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

Show more
Parametry nagłówka
Content-type

string

Mandatory

application/json

Show more
Authorization

string

Mandatory

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

Show more
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.

Show more
Parametry żądania
cardInfo

object

Mandatory

Object that defines the payment operation request fields.

Show more
PAN

string <= 40 characters

Optional

The Primary Account Number (credit card number).

Show more
secureCode

string <= 40 characters

Optional

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

Show more
validationDate

ISODateTime

Mandatory

The expiration date of the credit card.

Show more
cardholderName

string

Mandatory

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

Show more
createToken

boolean

Mandatory

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

Show more

Oto przykład, jak dokonać jednorazowego zakupu:

{
    "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ć.

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.

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 wynikustatusMsgOpisDziałanie
HTTP-200SukcesPozytywna odpowiedźnie dotyczy
HTTP-400Zł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-401NieautoryzowanyW 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-403ZabronionyIdentyfikator 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-405Niedozwolona metodaZastosowana metoda HTTP nie jest zgodna z żadną dostępną definicją API.Sprawdź w API Market poprawną metodę HTTP.
HTTP-429Zbyt dużo próśbPrzekroczono limit szybkości połączeń API.Informacje na temat limitów stawek mających zastosowanie do API można znaleźć w API Market.
HTTP-500Wewnętrzny błąd serweraWywoł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-503serwis niedostępnyWywoł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.