Płatności kartami są dostępne dla kart Visa, Mastercard i kart co-branded, a ponieważ przykład użycia może się nieznacznie różnić w zależności od konkretnego przypadku, dlatego w tej sekcji opiszemy jednorazowy zakup, ale możesz także mieć dostęp do kilka różnych przypadków użycia.
Oprócz kart Visa i Mastercard, SIBS Gateway obsługuje także karty marek partnerskich, takie jak Cartes Bancaires.
3D Secure
Autoryzacja płatności z uwierzytelnianiem 3DSecure (bezproblemowa lub kwestionowana).
Store cards
Zapisz dane kupującego i dokonuj płatności cyklicznych i abonamentowych.
Karta OneClick
Aktywuj najprostszy i najszybszy sposób akceptowania płatności.
Webhooki
Bądź na bieżąco ze zmianami statusów płatności.
Skorzystaj z transakcji zakupu jednorazowego, jeśli chcesz natychmiast obciążyć kupującego opłatą.
| Opcja płatności | Kategoria | Kraje | Waluty | Cechy | Integracje |
| Karta | Karty kredytowe i debetowe | Czechy, Estonia, Francja, Niemcy, Węgry, Portugalia, Polska, Rumunia, Słowacja | CZK, EUR, HUF, PLN, RON | 3D Secure OneClick/Bez kodu Wstępnie autoryzowane przechwytywanie Zakup jednorazowy Częściowe przechwytywanie Częściowy zwrot kosztów Subscrypcje Zwrot kosztów Anulowanie Wirtualny Terminal | API Formularz Płatności Wtyczka Prestashop Wtyczka WooCommerce Wtyczka Magento |
Jednorazowy zakup
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.
W tym żądaniu Bearer Token zostaje zastąpiony przez odpowiedź checkoutu transactionSignature.
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
Element do zapytania o status transakcji według identyfikatora transakcji.
Parametry nagłówka
Parametry żądania
string <= 40 characters
The security code (CVV/CVC) associated with the credit card.
string
The name of the cardholder as it appears on the credit card.
boolean
A flag indicating whether to create a token for future use or not (true/false).
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 autentykacją 3D Secure.
- 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 on, czy transakcja została zaakceptowana, odrzucona, nadal 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}/statusNagłówki żądań:
Autorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6I (...)
X-IBM-Client-Id: b4480347-9fc8-4790-b359-100a99c60ea3
Content-Type: application/jsonPomyś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 | Akcja |
|---|---|---|---|
| HTTP-200 | Sukces | Odpowiedź powodzenia | 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 prawidłowej 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 zapytań | Przekroczono limit szybkości wywołań 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. |
Cartes Bancaires
SIBS Gateway obsługuje także francuską sieć Cartes Bancaires. Sprawdź poniżej, w jaki sposób możesz wykonać żądanie POST między serwerami, aby wygenerować transakcję z Cartes Bancaires.
- Utwórz zamówienie, używając CRTB jako metody płatności.
Poniżej przykład realizacji zamówienia:
- Po pomyślnym złożeniu zamówienia można przystąpić do realizacji zamówienia.
Poniższy komunikat przedstawia zakup jednorazowy, w ramach którego następuje płatność. Poniżej znajdują się szczegóły dotyczące parametrów wiadomości żądania:
Parametry żądania
ciąg <= 40 znaków
Kod zabezpieczający (CVV/CVC) powiązany z kartą kredytową.
ścieżka
Imię i nazwisko posiadacza karty widniejące na karcie kredytowej.
wartość logiczna
Flaga wskazująca, czy utworzyć token do wykorzystania w przyszłości, czy nie (prawda/fałsz).
ścieżka
Typ routingu marki karty – dla Cartes Bancaire należy ustawić na CRTB.
Po dokonaniu płatności otrzymasz odpowiedź zawierającą w wiadomości status płatności. Informuje on, czy transakcja została zaakceptowana, odrzucona, nadal oczekuje na ostateczny wynik lub wymaga dodatkowych działań.
- Uzyskaj status płatności
Następnie, po przetworzeniu płatności, możesz sprawdzić status swojej transakcji, wysyłając żądanie GET