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 Karta OneClick) do połączenia.
ścieżka
Opcjonalny element do sprawdzania statusu transakcji według identyfikatora transakcji.
Parametry nagłówka
Parametry żądania
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ć.
- Płatność ze wstępnie autoryzowanym i późniejszym przechwytywaniem w przypadku, gdy pobierasz opłatę (całkowitą lub częściową) dopiero w momencie dostarczenia zamówienia.
- 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.
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. |