Integrare pagamenti JCB per piattaforme Connect e account connessi

Le piattaforme Connect possono consentire ai propri account connessi in Giappone di accettare pagamenti JCB.

Il flusso di attivazione JCB per gli account connessi varia a seconda del momento in cui vengono creati l'account della piattaforma Connect e l'account connesso.

Piattaforme create dopo il 17-10-2024

Per gli account connessi creati dopo il 16-12-2024, puoi iniziare ad accettare immediatamente le carte JCB, Diners Club e Discover. In passato, ciò era possibile solo per carte Visa, Mastercard e American Express, mentre JCB richiedeva un'ulteriore revisione per questi circuiti di carte.

Mentre tu puoi iniziare ad accettare immediatamente queste carte, JCB esamina in automatico tutti gli account. In alcuni casi, JCB potrebbe rifiutare il tuo account o richiedere informazioni aggiuntive su di te o sulla tua attività.

Verificare lo stato di registrazione degli account connessi

Nel momento in cui JCB avrà preso una decisione sulla richiesta di registrazione dell'account connesso, Stripe ti avviserà con un webhook. Dopo l'approvazione o il rifiuto del tuo account da parte di JCB, Stripe invierà un webhook capability.updated.

Se JCB richiede ulteriori informazioni sull'account connesso, Stripe ti contatterà tramite email. Fino a quando il tuo account connesso non sarà stato approvato da JCB, Stripe sospenderà temporaneamente la capacità dell'account connesso di accettare nuovi pagamenti JCB. Tutti i pagamenti JCB elaborati prima della sospensione verranno automaticamente rimborsati.

Piattaforme create prima del 17-10-2024

In fase di creazione dell'account, dovrai richiedere la funzionalità jcb_payments. Se riscontri un errore durante la richiesta della funzionalità, scrivi all'indirizzo japan-jcb-payments@stripe.com.

Esempio di codice Python: richiesta della funzionalità in fase di creazione di un nuovo account

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

Esempio di URL OAuth: richiesta della funzionalità in fase di creazione di un nuovo account

​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

Esempio di codice Python: richiesta della funzionalità per l'account connesso esistente

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

Approvazione e rifiuto

In alcuni casi, JCB richiederà ulteriori informazioni o azioni da parte tua o del tuo account connesso. In tal caso, Stripe ti avviserà tramite email.

Nel momento in cui JCB avrà preso una decisione sulla richiesta di registrazione dell'account, Stripe ti avviserà con un webhook. Dopo l'approvazione o il rifiuto del tuo account da parte di JCB, Stripe invierà un webhook capability.updated.

Risultato della registrazione

Dettagli webhook

Approvata

type: "capability.updated"
data.object.id: "jcb_payments"
data.object.status: "active"
account: ID dell'account connesso che è stato approvato

Rifiutata

type: "capability.updated"
data.object.id: "jcb_payments"
data.object.status: "inactive"
account: ID dell'account connesso che è stato rifiutato

Decisione in sospeso

type: "capability.updated"
data.object.id: "jcb_payments"
data.object.status: "pending"
account: ID dell'account connesso per cui è stata richiesta la registrazione

Verificare lo stato di registrazione degli account connessi

Puoi verificare lo stato della registrazione a JCB del tuo account connesso richiedendo lo stato della funzionalità jcb_payments tramite l'API Capabilities.

Esempio di codice Python:

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

Risultato della registrazione

Risposta dell'API Capabilities

Approvata

status: "active"

Rifiutata

status: "inactive"

Non registrata

status: "unrequested"

Decisione in sospeso

status: "pending"

Piattaforme non giapponesi

Per consentire ai tuoi account connessi giapponesi di accettare JCB, per prima cosa contattaci per abilitare la funzionalità jcb_payments per la tua piattaforma. A quel punto potrai fornire risposte sulla tua integrazione Stripe nelle impostazioni regionali di Connect. Dopo aver inviato i tuoi dati, potrai iniziare a richiedere la funzionalità per i tuoi account connessi.

Se i tuoi account connessi non sono in Giappone, non avrai bisogno della funzionalità jcb_payments per accettare le carte JCB.

Ulteriori informazioni