Integrare pagamenti JCB per piattaforme Connect e account connessi

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

JCB può avere ulteriori indicazioni sui tipi di addebito preferiti e/o accettabili per una particolare piattaforma. In alcune situazioni si può preferire che la piattaforma sia l'esercente del saldo, in altre può essere necessario che gli account connessi siano l'esercente del saldo. Nel primo caso l'importo deve essere addebitato sulla piattaforma senza usare il parametro on_behalf_of, mentre nel secondo caso è necessario utilizzarlo.

Nuovi account Connect

Se stai attivando Stripe, prevedi di utilizzare Connect e desideri accettare pagamenti JCB per gli account Connect, prima di tutto contatta japan-jcb-payments@stripe.com.

Piattaforme Connect esistenti

Accesso per gli account in cui la piattaforma riscuote le commissioni

Dovrai richiedere l'iscrizione a JCB per conto dei tuoi account connessi.

Registrare nuovi account

In fase di creazione dell'account, dovrai richiedere la funzionalità jcb_payments, nonché card_payments e transfers.

Esempio di codice Python:

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

Esempio di URL OAuth:

​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

Registrare account connessi esistenti

Dovrai richiedere jcb_payments tramite l'API Capabilities.

Esempio di codice Python:

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

Accesso per gli account in cui Stripe riscuote le commissioni

I nuovi account connessi verranno registrati automaticamente in JCB.

Gli account connessi esistenti dovranno richiedere l'approvazione di JCB tramite la Dashboard. Consulta Abilitare JCB per account Stripe in Giappone.

Le piattaforme Connect non possono registrare gli account connessi in cui Stripe riscuote le commissioni per loro conto. Devono invece contattare direttamente i titolari degli account e informarli del fatto che devono abilitare JCB sulla propria Dashboard.

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"

Accettazione, integrazione e test

Ti comunicheremo tramite email l'esito della valutazione di JCB. Una volta ottenuta l'approvazione, potrai iniziare a creare e a testare la tua integrazione. Per informazioni sull'integrazione, consulta Integrare pagamenti JCB su account Stripe in Giappone.

Puoi testare tutti i tipi di addebito in modalità di test prima che l'attivazione JCB sia completata, ma non potrai utilizzarli in modalità live.

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