JCB J/Secure
JCB J/Secure is the authentication service in the JCB card network that uses the 3-D
Secure protocol to validate customers at checkout. When you request an authorization
using a supported card type and a supported processor, you can include payer
authentication data in the request. The payer authentication services enable you to add
payer authentication support to your website without running additional software on your
server.
Before implementing payer authentication for JCB J/Secure, contact customer support to
have your account configured for this feature.
Fields Specific to the JCB J/Secure Use Case
These API fields are required specifically for this use case.
- ccAuthService_cavv
- Required when payer authentication is successful.
- ccAuthService_xid
- Required when payer authentication is successful.
- ccAuthService_eciRaw
- Required when the payer authentication validation service returns a raw ECI value.
- ccAuthService_commerceIndicator
- Set this field to one of these values:
- js: Successful authentication for a JCB card (3-D Secure value of05).
- js_attempted: Authentication was attempted for a JCB card (3-D Secure value of06).
- js_failure: orinternet: Authentication failed or was not attempted for a JCB card (3-D Secure value of07).
Endpoint
Set the
ccAuthService_run
field to
true
.Send the request to
https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
.Related Information
Required Fields for Processing an Authorization Using JCB J/Secure Authentication
Use these required fields to process an authorization using JCB J/Secure
authentication.
When relaxed requirements for address data and the expiration date are being used, not all fields
in this list are required. It is your responsibility to determine whether your
account is enabled to use this feature and which fields are required. For details
about relaxed requirements, see Relaxed Requirements for Address Data and Expiration Date in Payment Transactions.
- billTo_city
- billTo_country
- billTo_email
- billTo_firstName
- billTo_lastName
- billTo_postalCode
- billTo_state
- billTo_street1
- card_accountNumber
- card_expirationMonth
- card_expirationYear
- ccAuthService_cavv
- Required when payer authentication is successful. Otherwise, this field is optional.
- ccAuthService_commerceIndicator
- Set this field to one of these values:
- js: Successful authentication for a JCB card (3-D Secure value of05).
- js_attempted: Authentication was attempted for a JCB card (3-D Secure value of06).
- js_failure: Authentication failed or was not attempted for a JCB card (3-D Secure value of07).
- ccAuthService_xid
- merchant_referenceCode
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
Related Information
Simple Order Example: Processing an Authorization Using JCB J/Secure
Authentication
Request
billTo_city=Sao Paulo billTo_country=BRbillTo_email=null@cybersource.combillTo_firstname=Julia billTo_lastname=Fernandez billTo_postalCode=01310-000 billTo_state=SP billTo_street1=R. Augusta card_accountNumber=41111111XXXXXXXX card_expirationMonth=12 card_expirationYear=2026 ccAuthService_run=true ccAuthService_cavv=ABCDEFabcdefABCDEFabcdef0987654321234567 ccAuthService_commerceIndicator=js ccAuthService_xid=MID23 merchant_referenceCode=Merchant_REF purchaseTotals_currency=mxn purchaseTotals_grandTotalAmount=100
Response to a Successful Request
merchantReferenceCode=Merchant_REF request_id=6461515866500167772420 decision=ACCEPT reasonCode=100 purchaseTotals_currency=mxn ccAuthReply_cardCategory=F ccAuthService_reconciliationID=ZUDCXJO8KZRFXQJJ ccAuthReply_reasonCode=100 ccAuthReply_amount=100.00 ccAuthReply_avsCode=5 ccAuthReply_authorizationCode=570110 ccAuthReply_processorResponse=1 ccAuthReply_authorizedDateTime=2022-03-01T161947Z ccAuthReply_paymentNetworkTransactionID=111222