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 Visa i Mastercard, SIBS Gateway obsługuje także karty pod wspólną marką 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ą.
| Metoda płatności | Kategoria | Kraje | Waluty | Funkcjonalności | Integracje |
| Card | Karty kredytowe i debetowe | Czechy, Estonia, Francja, Niemcy, Polska, Portugalia, Rumunia, Słowacja, Węgry | 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 Zwroty 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 endpointy | Opis działania |
| 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.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 transactionsignaturezwró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 OneClick) do połączenia.
ciąg
Element do zapytania o status transakcji według identyfikatora transakcji.
Parametry nagłówka
Parametry zapytania
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ść z preautoryzacją i późniejszym przejęciem, w przypadku gdy pobierasz opłatę dopiero w momencie dostarczenia zamówienia (całkowitego lub częściowego).
- 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.
- Odrzucono: Zakup został odrzucony.
- W toku: Ostateczny wynik zakupu nie jest jeszcze znany. Konieczne będzie zapytanie o status tej transakcji, dopóki nie osiągnie ona stanu końcowego lub użytkownik nie zdecyduje się jej anulować.
- Partial: (częściowy): zakup został częściowo zaakceptowany, ale wymaga wykonania dodatkowych czynności (np. Uwierzytelnianie 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, wykonując zapytanie GET .
Nagłówek HTTP autoryzacji jest ustawiony na Bearer Token, który został użyty w początkowym Checkout’cie.
Adres URL żądania:
https://stargate.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:
| Result Code | statusMsg | Description | Action |
|---|---|---|---|
| HTTP-200 | Success | Success response | N/A |
| HTTP-400 | Bad Request | The JSON payload is not matching the API definition or some mandatory HTTP headers are missing. | Please check in API Market for the correct syntax. |
| HTTP-401 | Unauthorized | On the Authorization, Bearer token is invalid/expired or not associated with the Terminal used. | Please check in SIBS Backoffice under the Credentials if the token is valid and create a new one if needed. |
| HTTP-403 | Forbidden | The ClientID set on the X-IBM-Client-Id HTTP header is not valid or does not possess a valid subscription to the API. | Please check in SIBS Backoffice under the SPG APP 2.0 if the ClientID is correct. If the problem persists contact SIBS Gateway support for a ClientID reset. |
| HTTP-405 | Method Not Allowed | The HTTP Method used is not matching any of the API definitions available. | Please check in API Market for the correct HTTP Method. |
| HTTP-429 | Too Many Requests | The API calls rate limit has been exceeded. | Please check in API Market for information on the rate limits that apply to the API. |
| HTTP-500 | Internal Server Error | The API call has failed… and its most likely on our side. | You should retry the operation, and if the problem persists contact SIBS Gateway support for assistance. |
| HTTP-503 | Service Unavailable | The API call is not currently available. Usually we are always on, but short availability issues may occur during scheduled maintenance. | You should wait and try again later. |
Cartes Bancaires
SIBS Gateway obsługuje również karty pod wspólną marką 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 zapytania
ciąg <= 40 znaków
Kod zabezpieczający (CVV/CVC) powiązany z kartą kredytową.
ciąg
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).
ciąg
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