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.
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, Francja, Niemcy, Węgry, Portugalia, Polska, Rumunia, Słowacja, Słowenia | 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.
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
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}/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:
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 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