worldline Direct
Sign up

Cartes Bancaires

Intro

Cartes Bancaires (CB) is the local card scheme in France and by far the most commonly issued brand there. CB cards are always co-badged with Visa, MasterCard or (although not very often) Maestro. This allows French customers to use their CB card outside of France.

Following the introduction of EU regulations, you need to offer your French customers CB in addition to Visa / MasterCard / Maestro. This empowers your customers to choose between the different brands.

To comply with this regulation, we offer you the following options for the respective integration method:

  • Create Payment API: Offer your customers CB on your payment page and create the payment as a CB transaction by sending paymentProductId=130

  • HostedCheckout API: You have two possibilities
    1. Offer your customers CB on your payment page and create the payment as a CB transaction by sending PaymentProductID=130.
    2. Do not send PaymentProductID at all. The customers can choose their preferred brand on our Hosted Payment Page.

If you have an acquiring contract with a French acquirer, this brand will be available by default, provided it has been added in your account.

Überblick

Payment Product-ID:
130
Wichtigste Vorteile
  • Lower scheme and acquirers fees
  • Preferred payment method for French customers
  • Lower fraud rate compared to Visa / MasterCard
  • Card payments enable e-commerce with a real-time authorization approval/decline response supporting the faster delivery of goods and services to the consumer
  • Secure payments
  • Fast settlement cycle
  • International acceptance(as CB cards are co-badged with Visa / MasterCard)

Einstieg

Please make sure that this payment method is activated in your Back Office in Configuration > Payment methods. If this is not the case, contact us.

Länder & Währungen

Unterstützte Länder

Unterstützte Währungen

  • Euro

Integration

Diese Zahlungsarten bieten wir für die folgenden Integrationsmodi an. In unseren Anleitungen erfahren Sie mehr über die genauen Unterschiede:

Im Kapitel „Zahlungsablauf“ finden Sie eine Übersicht.

Je nach Integrationsmodus gelten Unterschiede:

Hosted Checkout Page

Fügen Sie die folgenden Merkmale zu einer CreateHostedCheckout-Standardanfrage hinzu:


{
	"HostedCheckoutSpecificInput": {
		"ReturnUrl": "https://yourReturnUrl.com"
	},
	"Order": {
		"AmountOfMoney": {
			"Amount": 100,
			"CurrencyCode": "EUR"
		}
	}
}
Merkmale Hinweise

hostedCheckoutSpecificInput.returnURL

Die URL, an die wir Ihre Kunden weiterleiten, nachdem die Zahlung beendet ist.

order.amountOfMoney
     amount
     currencyCode

amount: Der Bruttobetrag, den Sie für diese Bestellung erheben möchten
currencyCode: Der ISO 4217-Währungscode für diesen Betrag

Ausführliche Informationen über dieses Objekt und seine Eigenschaften finden Sie in unserer CreateHostedCheckoutAPI

Hosted Tokenization Page

Fügen Sie einer Create Payment-Standardanfrage die folgenden Merkmale hinzu (einschließlich notwendiger 3-D Secure-Parameter), nachdem Sie die Karte tokenisiert haben:


{
	"CardPaymentMethodSpecificInput": {
		"Token": "tokenId",
		"ThreeDSecure": {
			"RedirectionData": {
				"ReturnUrl": "https://yourRedirectionUrl.com"
				}
			}
		},
		"Order": {
			"AmountOfMoney": {
				"Amount": 100,
				"CurrencyCode": "EUR"
			},
			"Customer": {
				"Device": {
                                "AcceptHeader": 
"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3", "Locale": "en_EN", "TimezoneOffsetUtcMinutes": -180, "UserAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/75.0.3770.142 Safari/537.36", "Browserdata": { "ColorDepth": 24, "JavaScriptEnabled": false, "ScreenHeight": "1080", "ScreenWidth": "1920" } } } } }
Properties Remarks

cardPaymentMethodSpecificInput.token

Die tokenisierten Anmeldedaten für die Kreditkarte, die Sie bei der Tokenisierung der Anmeldedaten/beim Erhalt des Tokens bekommen haben. Erfahren Sie mehr in unserer Anleitung Hosted Tokenization Page.

cardPaymentMethodSpecificInput.threeDSecure 
     redirectionData.returnURL
     skipAuthentication

returnURL: Die URL, an die wir Ihre Kunden weiterleiten, nachdem die Zahlung beendet ist.
skipAuthentication: Angabe, ob 3-D Secure für diese Bestellung gestartet werden soll.

order.amountOfMoney
     amount
     currencyCode

amount: Der Bruttobetrag, den Sie für diese Bestellung erheben möchten
currencyCode: Der ISO 4217-Währungscode für diesen Betrag

customer.device
     acceptHeader
     locale
     timezoneOffsetUtcMinutes
     userAgent
     browserdata
          colorDepth
          javaScriptEnabled
          screenHeight
          screenWidth

Minimale Merkmale für die Erfüllung der SCA-Vorschriften für die 3-D Secure-Authentifizierung.

In unserer Anleitung erfahren Sie, wie Sie eine korrekte 3-D Secure-Anfrage stellen. In unserer API-Referenz lernen Sie mehr über die Merkmale.

Ausführliche Informationen über dieses Objekt und seine Eigenschaften finden Sie in unserer HostedTokenizationAPICreatePaymentAPI

Server-to-server

Fügen Sie einer Create Payment-Standardanfrage die folgenden Merkmale hinzu (einschließlich notwendiger 3-D Secure-Parameter):

{
	"CardPaymentMethodSpecificInput": {
		"PaymentProductId": XXX,
		"SkipAuthentication": false,
		"Card": {
			"CardholderName": "John Doe",
			"CardNumber": "0000000000000000",
			"Cvv": 123,
			"ExpiryDate": 1236
		},
		"ThreeDSecure": {
			"RedirectionData": {
				"ReturnUrl": "https://yourRedirectionUrl.com"
			}
		}
	},
	"Order": {
		"AmountOfMoney": {
			"Amount": 100,
			"CurrencyCode": "EUR"
		},
		"Customer": {
			"Device": {
				"AcceptHeader": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3",
				"Locale": "en_EN",
				"TimezoneOffsetUtcMinutes": -180,
				"UserAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/75.0.3770.142 Safari/537.36",
				"Browserdata": {
					"ColorDepth": 24,
					"JavaScriptEnabled": false,
					"ScreenHeight": "1080",
					"ScreenWidth": "1920"
				}
			}
		}
	}
}
Merkmale Hinweise

cardPaymentMethodSpecificInput.paymentProductId

cardPaymentMethodSpecificInput.card
     cardholderName
     cardNumber
     cvv
     expiryDate

cardPaymentMethodSpecificInput.ThreeDSecure
     redirectionData.returnURL
     skipAuthentication

paymentProductId: Der numerische Identifikator der Zahlungsart auf unserer Plattform. Diese ID finden Sie im Kapitel "Überblick".


cardPaymentMethodSpecificInput.card: Die Anmeldedaten für die Karte, die für die Zahlung verwendet wird.
Denken Sie daran, die notwendigen PCI DSS-Anforderungen für das Versenden von sensiblen Daten zu beachten.

returnURL: Die URL, an die wir Ihre Kunden weiterleiten, nachdem die Zahlung beendet ist.
skipAuthentication: Angabe, ob 3-D Secure für diese Bestellung gestartet werden soll.

order.amountOfMoney
     amount
     currencyCode

amount: Der Bruttobetrag, den Sie für diese Bestellung erheben möchten
currencyCode: Der ISO 4217-Währungscode für diesen Betrag

customer.device
     acceptHeader
     locale
     timezoneOffsetUtcMinutes
     userAgent
     browserdata
          colorDepth
          javaScriptEnabled
          screenHeight
          screenWidth

Minimale Merkmale für die Erfüllung der SCA-Vorschriften für die 3-D Secure-Authentifizierung.

Schauen Sie in unserer Anleitung nach, um zu erfahren, wie Sie eine korrekte 3-D Secure-Anfrage stellen. In unserer API Referenz lernen Sie mehr über die Merkmale.

Ausführliche Informationen über dieses Objekt und seine Eigenschaften finden Sie in unserer CreatePaymentAPI

Zahlungsablauf

Wir bieten diese Zahlungsmethode für alle unsere Integrationsmodi an. Unabhängig vom gewählten Modus folgt der Ablauf einigen grundlegenden Schritten, die im Folgenden beschrieben werden. In unseren Anleitungen erfahren Sie mehr über die genauen Unterschiede.

  1. Ihre Kunden schließen eine Bestellung in Ihrem Shop ab und wählen diese Zahlungsart.
  2. Sie senden eine CreateHostedCheckout/CreatePayment Anfrage an unsere Plattform. Je nach Integrationsmodus gelten Unterschiede. Im Kapitel „Integration“ finden Sie Beispiele für jeden Modus.
  3. Unsere Plattform sendet Ihnen eine Antwort mit Anweisungen für die nächsten Schritte im Ablauf.
  4. Ihre Kunden geben ihre Kreditkartennummer an und werden zwecks 3-D Secure Authentifizierung zu ihrem Kreditkartenherausgeber umgeleitet.
  5. Unser System erhält das Ergebnis der 3-D Authentifizierung vom Kreditkartenherausgeber.
  6. Wir verarbeiten die Transaktion und erhalten das Ergebnis vom Acquirer.
  7. Wir leiten Ihren Kunden um zu Ihrer returnUrl.
  8. Sie fragen das Ergebnis der Transaktion via GetPayment bei unserer Plattform an oder Sie erhalten das Ergebnis via Webhooks.
  9. Wenn die Transaktion erfolgreich verlaufen ist, können Sie die Güter / Dienstleistungen ausliefern.
CC-flow.png

Testdaten

In unseren Testszenarios finden Sie Testdaten und detaillierte Instruktionen. 

Stellen Sie sicher, den korrekten Endpunkt anzusteuern und zurück zum Live-Endpunkt zu wechseln, sobald Sie Ihre Tests abgeschlossen haben

Was this page helpful?

Do you have any comments?

Thank you for your response.