Cartes Bancaires (CB) to krajowy schemat kart płatniczych we Francji, szeroko wykorzystywany przez francuskie banki i często wydawany jako karty współbrandowane z Visa lub Mastercard.
SIBS Gateway obsługuje przetwarzanie transakcji Cartes Bancaires, umożliwiając akceptantom kierowanie kwalifikujących się płatności kartowych przez sieć CB zamiast przez standardowy schemat kartowy.

Cartes Bancaires można zintegrować przy użyciu:

• Server-to-Server API
• Formularz Płatności SIBS

Gdy usługa Cartes Bancaires jest dostępna, interfejs płatności może wyświetlić klientowi opcję wyboru Cartes Bancaires jako preferowanej ścieżki routingu płatności przed jej finalizacją.
Jeśli ta opcja nie zostanie wybrana, transakcja zostanie zrealizowana w standardowym przepływie płatności i przetworzona przez domyślny schemat kartowy (np. Visa lub Mastercard).

Poniższe sekcje opisują kroki wymagane do przetworzenia płatności z użyciem Cartes Bancaires za pośrednictwem SIBS Gateway.

1. Utworzenie zamówienia z użyciem CRTB jako metody płatności

Pierwszym krokiem jest utworzenie zamówienia przy użyciu standardowego przepływu integracji płatności kartowych.
Jeśli płatność może zostać przetworzona przez sieć Cartes Bancaires, odpowiedź może zawierać CRTB na liście dostępnych metod płatności.

CRTB jest identyfikatorem używanym przez SIBS Gateway do oznaczenia routingu płatności Cartes Bancaires.

To zapytanie ma taką samą strukturę jak w przypadku standardowych płatności kartowych. Aby uzyskać więcej informacji o strukturze zapytania, zapoznaj się ze stroną Integracja.
Poniżej znajduje się przykład utworzenia zamówienia.

Po pomyślnym utworzeniu zamówienia, odpowiedź może wskazywać, że usługa Cartes Bancaires jest dostępna dla tej transakcji.

Aby potwierdzić, że transakcja może zostać zrealizowana z użyciem Cartes Bancaires, należy sprawdzić następujące pola w odpowiedzi:

</> JSON

{
  "paymentMethodList": [
    "CARD",
    "CRTB"
  ],
  "cartesBancaires": {
    "cartesBancairesService": "true"
  }
}

• CRTB w polu paymentMethodList wskazuje, że Cartes Bancaires jest dostępne jako opcja routingu płatności dla tej transakcji;
• cartesBancairesService: true potwierdza, że transakcja może zostać przetworzona przez sieć Cartes Bancaires.

Ta odpowiedź wskazuje, że transakcja może być kontynuowana z użyciem usługi Cartes Bancaires.

2. Wykonanie żądania zakupu

Po pomyślnym utworzeniu zamówienia (Krok 1), następnym etapem jest wykonanie żądania płatności dla transakcji. Na tym etapie przekazywane są dane karty wymagane do przetworzenia płatności, a transakcja jest wysyłana do autoryzacji.

Poniżej znajduje się przykład żądania transakcji jednorazowego zakupu z użyciem Cartes Bancaires (CRTB). Tabela zawiera wszystkie wymagane i opcjonalne parametry żądania.

Parametry żądania

Field	Type	Condition	Description	Example
cardInfo	object	Wymagane	Obiekt definiujący pola żądania operacji płatniczej.	–
cardInfo.PAN	string ≤ 40	Opcjonalne	Primary Account Number (numer karty płatniczej).	497010******0154
cardInfo.secureCode	string ≤ 40	Opcjonalne	Kod bezpieczeństwa (CVV/CVC) powiązany z kartą.	123
cardInfo.validationDate	ISODateTime	Wymagane	Data ważności karty płatniczej.	(2028-12-01T00:00:00.000Z)
cardInfo.cardholderName	string	Wymagane	Imię i nazwisko posiadacza karty, tak jak widnieje na karcie.	John Doe
cardInfo.createToken	boolean	Wymagane	Określa, czy należy utworzyć token do przyszłego użycia.	false
cardInfo.cardBrandRoutingType	string Exact4Text	Wymagane	Określa sieć routingu używaną do przetwarzania transakcji kartowej. Dla transakcji Cartes Bancaires wartość musi wynosić CRTB.	CRTB

Po wykonaniu płatności zostanie zwrócona odpowiedź zawierająca pole paymentStatus w komunikacie.
Pole to informuje, czy transakcja została:

• Zaakceptowana
• Odrzucona
• Nadal oczekuje na ostateczny wynik
• Wymaga dodatkowej akcji (np. 3DS challenge, DCC itp.)

Uwaga: aby włączyć Cartes Bancaires, integrator musi uwzględnić w żądaniu następujący fragment:

</> JSON
{
  "cardInfo": {
    "cardBrandRoutingType": "CRTB"
  }
}

Powyższa odpowiedź wskazuje, że transakcja została przyjęta do przetwarzania i że usługa jest włączona, co pozwala bramce płatniczej kontynuować przetwarzanie transakcji z użyciem Cartes Bancaires.

3. Sprawdzenie statusu płatności

Po przetworzeniu płatności możesz sprawdzić status transakcji, wykonując żądanie GET.
Żądanie to umożliwia pobranie wyniku płatności, w tym informacji, czy została zaakceptowana odrzucona, oczekująca, wymagająca dodatkowej akcji.

Możesz przetestować to żądanie GET w Postmanie, aby zobaczyć odpowiedź w czasie rzeczywistym i potwierdzić wynik płatności.

Po wykonaniu żądania, możesz przeanalizować odpowiedź zwróconą przez API.
Poniższe pola wskazują końcowy wynik transakcji:

</> JSON
{
  "transactionID": "ScHR4JHgQXd4vrFQw1n9",
  "amount": {
    "currency": "EUR",
    "value": "50.50"
  },
  "paymentStatus": "Success",
  "returnStatus": {
    "statusCode": "000",
    "statusMsg": "Success"
  }
}

• paymentStatus wskazuje aktualny stan płatności (np. Success, Declined, Pending).
• returnStatus.statusCode zawiera techniczny wynik żądania.
• transactionID identyfikuje sprawdzaną transakcję.