Integrare pagamenti JCB per piattaforme Connect e account connessi

Le piattaforme Connect possono consentire ai propri account connessi domiciliati 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 il venditore del saldo, in altre può essere necessario che gli account connessi siano il venditore 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 registrarti su Stripe 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.

Iscrizione di nuovi account

Durante la 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

Iscrizione di 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 propria Dashboard. Vedi Abilitare pagamenti JCB per account Stripe in Giappone.

Le piattaforme Connect non sono in grado di registrare gli account connessi in cui Stripe riscuote le commissioni per loro conto. Devono invece contattare direttamente i titolari degli account e informarli di 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.

Quando JCB avrà preso una decisione sulla richiesta di registrazione del tuo 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 dell'iscrizione

Dettagli webhook

Approvati

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 l'iscrizione

Verificare lo stato della registrazione di account connessi

Puoi verificare lo stato della registrazione 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 dell'iscrizione

Risposta dell'API Capabilities

Approvati

status: "active"

Rifiutata

status: "inactive"

Non iscritta

status: "unrequested"

Decisione in sospeso

status: "pending"

Accettazione, integrazione e test

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

Puoi testare tutti i tipi di addebito con la 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. Sarai quindi in grado di fornire risposte sulla tua integrazione Stripe nelle impostazioni regionali di Connect. Dopo aver inviato le tue informazioni, potrai iniziare a richiedere la funzionalità per i tuoi account connessi.

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

Ulteriori informazioni