Integrating JCB payments for Connect platforms and connected accounts

Connect platforms can allow their Japan-based connected accounts to accept JCB payments.

JCB may have additional guidance on the preferred and/or acceptable charge types for a particular platform. In some cases they might prefer the platform to be the settlement merchant, while in other cases they may request the connected accounts to be the settlement merchant. The former requires charges on the platform to be made without on_behalf_of while the latter requires usage of this parameter.

New Connect accounts

If you are onboarding to Stripe and expect to use Connect, and you want to accept JCB payments for Connect accounts, please reach out to japan-jcb-payments@stripe.com first.

Existing Connect platforms

ACCESS FOR ACCOUNTS WHERE THE PLATFORM COLLECTS FEES

You will need to request JCB enrollment on behalf of your connected accounts.

Enrolling new accounts

You will need to request the jcb_payments capability when creating the account, along with card_payments and transfers.

Example Python code:

stripe.Account.create(
 country="JP",
 requested_capabilities=['jcb_payments', 'card_payments', 'transfers'],
)

Example OAuth URL:

​https://connect.stripe.com/express/oauth/authorize​
?redirect_uri={REDIRECT_URL}
&client_id={CLIENT_ID}
&state={STATE_VALUE}
&suggested_capabilities[]=transfers
&suggested_capabilities[]=card_payments
&suggested_capabilities[]=jcb_payments

Enrolling existing connected accounts

You will need to request jcb_payments via the Capabilities API.

Example Python code:

stripe.Account.modify_capability(
 "acct_1CmEuvFjAq3Pk1RD",
 "jcb_payments",
 requested=True,
)

ACCESS FOR ACCOUNTS WHERE STRIPE COLLECTS FEES

New connected accounts will be enrolled in JCB automatically.

Existing connected accounts will need to apply for JCB approval through their Dashboard. See Enabling JCB for Japan-based Stripe accounts.

Connect Platforms are not able to enroll connected accounts where Stripe collects fees on their behalf. Instead, they should contact the account owners directly to inform them to enable JCB on their Dashboard.

Approval and rejection

In some cases, JCB will request additional information or actions to be taken from you, or your connected account. If so, Stripe will notify you by email.

When JCB has made a decision on the application of your account, Stripe will notify you using a webhook.

When JCB has approved or rejected your account, Stripe will send a capability.updated webhook.

Enrollment result

Webhook data

Approved

type: "capability.updated"
data.object.id: "jcb_payments"
data.object.status: "active"
account: The ID of the connected account that was approved

Rejected

type: "capability.updated"
data.object.id: "jcb_payments"
data.object.status: "inactive"
account: The ID of the connected account that was rejected

Pending decision

type: "capability.updated"
data.object.id: "jcb_payments"
data.object.status: "pending"
account: The ID of the connected account that has been submitted for enrollment

Checking enrollment status of connected accounts

You can verify the status of your connected account’s JCB enrollment by querying the status of the jcb_payments capability via Capabilities API.

Example Python code:

stripe.Account.retrieve_capability(
 "acct_1CmEuvFjAq3Pk1RD",
 "jcb_payments",
)

Enrollment result

Response from Capabilities API

Approved

status: "active"

Rejected

status: "inactive"

Not enrolled

status: "unrequested"

Pending decision

status: "pending"

Acceptance, integration, and testing

We will inform you via email on the outcome of JCB's assessment. Once you have been approved, you can begin building and testing your integration. For integration information, see Integrating JCB payments on Japan-based Stripe accounts.

You can test all charge types in test mode before the JCB onboarding is completed, but you will not be able to use them in live mode.

Non-Japanese platforms

To allow your Japanese connected accounts accept JCB, first reach out to enable the jcb_payments capability for your platform. You will then be able to provide answers about your Stripe integration on your regional Connect settings. After submitting your information, you will be able to start requesting the capability for your connected accounts.

If your connected accounts are not in Japan, you do not need the jcb_payments capability to accept JCB cards.

Additional information