JCB Card Processing

Supported Transaction Types

• Authorisation AUTH

• Capture CAPT

• Purchase PURC

• Refund PARTIALREFUND

• Void GENERALVOID  

• Payouts ORIGINALCREDIT

• Recurring PURC

Integrations Supported

Deposit - Authorisation / Purchase

• Hosted Payment Page

• Direct Connect ( server-to-server)

Capture, Void, Refunds, Payouts, Recurring

• Hosted Payment Page

• Direct Connect ( server-to-server)

Currencies & Countries Supported

Additional properties to process Deposits

You MUST include the following properties. This informs us to proceed with routing the payment to JCB .

MobileNo - must be of length 10 digits and all numbers e.g. 1 2345678902

State - must be of length 2 digits and all numbers e.g. 12

ZIPCode - must be all numbers  e.g. 000001

if you are using our Hosted Payment Page

Sample requests using our Hosted Payment Page can be viewed here.

 {
  "TransactionType": "PURC",
  "Amount": "5000.00",
  "Currency": "JPY",
  "Language": "JA",
  "OrderReference": "MerchantOrder1",
  "UniqueReference": "00a00569-7b7d-43fa-a5d0-4aeb673c5a25",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "Routing": {
    "ForceBank": "JCBCARDSDC"
  },
  "IsTest": true,
  "Client": {
    "Email": "joe.bloggs@testjb.com",
    "FirstName": "Joe",
    "LastName": "Bloggs",
    "DateOfBirth": "1977-12-31",
    "Country": "JPN",
    "Street": "High Street",
    "City": "Valletta",
    "MobileNo": "7979797979",
    "State": "02",
    "ZIPCode": "12345",
    "IPAddress": "127.0.0.1"
  }
}

If you are using our direct connect solution (server-to-server)

Sample requests using Direct Connect can be viewed here.

 {
  "TransactionType": "PURC",
  "Amount": 10.23,
  "Currency": "JPY",
  "IsTest": true,
  "OrderReference": "123",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "FailRedirectionURL": "https://yourURLhere.com/FailRedirect/",
  "UniqueReference": "4b8da4f0-d3b4-44ae-8019-8c66905ffad7",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "PaymentCredentials": {
    "PaymentSource": "Card",
    "CardType": "JCB",
    "CardNumber": "6000000000001018",
    "CardHolderName": "Frictionless Processed",
    "ExpMonth": "12",
    "ExpYear": "2030",
    "CvV2": "666"
  },
  "Client": {
    "FirstName": "Apco",
    "LastName": "Test",
    "Email": "apcotest@test.com",
    "Street": "1,Street",
    "City": "Marsa",
    "IPAddress": "1.1.1.1",
    "ZIPCode": "MRS3000",
    "Country": "MLT",
    "State": "Rabat",
    "MobileNo": "+20100000000"
  },
   "BrowserDetails": {
    "UserAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
    "JavaEnabled": true,
    "ScreenColorDepth": "1",
    "ScreenWidth": "1080",
    "ScreenHeight": "840",
    "TimeZone": "2",
    "AcceptHeader": "application/json",
    "BrowserLanguage": "en"
  },
  "Routing": {
    "ForceBank": "ICARD"
  }
}

Requesting a Capture

If you wish to Capture a transaction of type Authorisation, below are the mandatory fields.

sample request for processing a capture request.

{
"TransactionType": "CAPT",
"Amount": 10.00,
"CallBackURL": "https://www.yourURLhere.com/Listener",
"IsTest": true,
"UniqueReference": "6514441d-8abe-4d7b-9e0c-3aa386333b34",
"PspID":"839791"
}