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.
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.
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, )
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.
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" |
Rejected |
type: "capability.updated" |
Pending decision |
type: "capability.updated" |
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 |
|
Rejected |
|
Not enrolled |
|
Pending decision |
|
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.
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.