Integração de pagamentos JCB para plataformas Connect e contas conectadas

As plataformas Connect podem permitir que as contas conectadas estabelecidas no Japão aceitem pagamentos pela JCB.

O fluxo de onboarding da JCB para contas conectadas varia de acordo com a data em que a conta da plataforma Connect e a conta conectada foram criadas.

Plataformas criadas depois de 17/10/2024

Você pode começar a aceitar cartões JCB, Diners Club e Discover imediatamente para contas conectadas criadas após 16/12/2024. Historicamente, isso só era possível para cartões Visa, Mastercard e American Express. A JCB exigia uma análise adicional dessas bandeiras de cartão.

Embora você possa começar a aceitar esses cartões imediatamente, a JCB revisará automaticamente todas as contas. Em alguns casos, a JCB poderá rejeitar sua conta ou solicitar informações adicionais sobre sua empresa ou você.

Verificação do status de inscrição de contas conectadas

Quando a JCB tomar uma decisão sobre seu pedido de abertura de conta conectada, a Stripe enviará a notificação por webhook. Quando a JCB aprovar ou rejeitar sua conta, a Stripe enviará um webhook capability.updated.

Se a JCB exigir mais informações sobre a conta conectada, a Stripe entrará em contato com você por e-mail. Até a aprovação da conta conectada pela JCB, a Stripe suspenderá temporariamente sua capacidade de aceitar novos pagamentos pela JCB. Qualquer pagamento pela JCB processado antes da suspensão será reembolsado automaticamente.

Plataformas criadas antes de 17/10/2024

Quando criar a conta, você precisará solicitar a função jcb_payments. Se encontrar algum erro, em contato com japan-jcb-payments@stripe.com.

Exemplo de código Python: para solicitar a função na criação de uma nova conta

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

Exemplo de URL do OAuth: para solicitar a função ao criar uma nova conta

​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

Exemplo de código Python: para solicitar a função na conta conectada existente

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

Aprovação e rejeição

Em alguns casos, a JCB solicitará que você ou sua conta conectada informe mais dados ou execute mais ações. Nesse caso, a Stripe notificará você por e-mail.

Quando a JCB tomar uma decisão sobre seu pedido de abertura de conta, a Stripe enviará a notificação por webhook. Quando a JCB aprovar ou rejeitar sua conta, a Stripe enviará um webhook capability.updated.

Resultado da inscrição

Dados do webhook

Aprovado

type: "capability.updated"
data.object.id: "jcb_payments"
data.object.status: "active"
account: o ID da conta conectada aprovada

Rejeitado

type: "capability.updated"
data.object.id: "jcb_payments"
data.object.status: "inactive"
account: o ID da conta conectada rejeitada

Decisão pendente

type: "capability.updated"
data.object.id: "jcb_payments"
data.object.status: "pending"
account: o ID da conta conectada enviada para inscrição

Verificação do status de inscrição de contas conectadas

Você pode verificar o status da inscrição de contas conectadas na JCB consultando o status da função jcb_payments pela API Capabilities.

Exemplo de código Python:

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

Resultado da inscrição

Resposta da API Capabilities

Aprovado

status: "active"

Rejeitado

status: "inactive"

Não inscrita

status: "unrequested"

Decisão pendente

status: "pending"

Plataformas não japonesas

Para permitir que suas contas conectadas japonesas aceitem JCB, primeiro entre em contato para ativar a função jcb_payments para sua plataforma. Em seguida, você poderá fornecer respostas sobre sua integração com a Stripe nas configurações regionais do Connect. Após enviar seus dados, você poderá começar a solicitar a função para suas contas conectadas.

Se suas contas conectadas não estão no Japão, você não precisa da função jcb_payments para aceitar cartões JCB.

Informações adicionais