---
title: "JCB Card Processing"
slug: "jcb-cards"
updated: 2026-02-27T08:13:49Z
published: 2026-02-27T08:13:49Z
canonical: "docs.apcopay.com/jcb-cards"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apcopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# JCB Card Processing

## Supported Transaction Types

- [x] Authorisation `AUTH`
- [x] Capture `CAPT`
- [x] Purchase `PURC`
- [x] Refund `PARTIALREFUND`
- [x] Void `GENERALVOID`
- [ ] Payouts `ORIGINALCREDIT`
- [ ] Recurring `PURC`

## Integrations Supported

**Deposit - Authorisation / Purchase**

- [x] Hosted Payment Page
- [x] Direct Connect ( server-to-server)

**Capture, Void, Refunds, Payouts, Recurring**

- [ ] Hosted Payment Page
- [x] Direct Connect ( server-to-server)

## Supported Wallet

- [ ] GooglePay
- [ ] Applepay

## Currencies & Countries Supported

| Title | Description |
| --- | --- |
| **Currencies Supported** | JPY |

## 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**

| Description | Hosted Payment Page |
| --- | --- |
| **Transaction Type** | "TransactionType": "PURC" |
| **Force Transaction Routing** | "Routing":{ "ForceBank": "JCBCARDSDC" } |
| **Client Details** | "Client" : { "Email": "[johndoe@gmail.com](mailto:johndoe@gmail.com)", "ClientAccount": "testing", "FirstName" : "Frictionless", "LastName" : "Processed", "Country": "JPN", "MobileNo": "1 2345678902", "Street": "Changun Road", "City": "Tokyo", "ZIPCode": "000001", "State": "12", "DateOfBirth" : "24-07-2000" } |
| **Test Indicator** | "isTest": true |

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

```json
 {
  "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)

| Description | Direct Connect |
| --- | --- |
| **Force Transaction Routing** | “Routing”:{ "ForceBank": "JCBCARDSDC” } |
| **Client Details** | "Client" : { "Email": "[johndoe@gmail.com](mailto:johndoe@gmail.com)", "ClientAccount": "testing", "FirstName" : "Frictionless", "LastName" : "Processed", "Country": "JPN", "MobileNo": "1 2345678902", "Street": "Changun Road", "City": "Tokyo", "ZIPCode": "000001", "State": "12", "DateOfBirth" : "24-07-2000" } |
| **Card Details** | "PaymentCredentials": { "PaymentSource": "Card", "CardType": "JCB", "CardNumber": "6351772561457936", "CvV2": "123", "ExpMonth": "02", "ExpYear": "2027", "CardHolderName": "Joe Smith" }, |
| **Browser details** | "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" } |
| **Test Indicator** | "isTest”: true |

Sample requests using **Direct Connect** can be viewed here.

```json
 {
  "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.

| Description | Direct Connect |
| --- | --- |
| **Transaction Reference** | "PspID": "342342” |

sample request for processing a `capture` request.

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