worldline Direct
Sign up

JCB

Intro

Japan Credit Bureau (JCB) was established in January 1961 and two months later issued Japan's first credit card. As Japanese tourists traveled abroad, Japan's credit card companies started issuing cards with US based international brands to secure acceptance abroad. JCB was the only one to decide to establish its own global acceptance and service network. Since the beginning of its international expansion in 1981 JCB acquired over 150 mln card members in 23 countries. JCB is also in a strategic alliance with Discover Network merchants in the United States, UnionPay merchants in China, American Express merchants in Canada, and RuPay merchants in India. As of January 8, 2018 JCB USA will no longer issue JCB cards in the American market, foreign JCB cards will continue to work through the Discover network partnership.

J/Secure

This is a payer authentication program from JCB.

Überblick

Payment Product-ID:
125
Wichtigste Vorteile
  • Autorisierung in Echtzeit
  • Sichere Zahlungen
  • Schneller Zahlungsausgleich
  • Internationale Akzeptanz

Länder & Währungen

Unterstützte Länder

Unterstützte Währungen

  • Australischer Dollar
  • Bahrain-Dinar
  • Brasilianischer Real
  • Kanadischer Dollar
  • Euro
  • Hongkong-Dollar
  • Indonesische Rupiah
  • Japanischer Yen
  • Malaysischer Ringgit
  • Neuer Taiwan-Dollar
  • Philippinischer Peso
  • Britisches Pfund
  • Singapur-Dollar
  • Südkoreanischer Won
  • Schweizer Franken
  • Thailändischer Baht
  • US-Dollar

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.