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 JCB.

A JCB pode ter orientações adicionais sobre os tipos de cobrança preferenciais e/ou aceitáveis para uma determinada plataforma. Em alguns casos, a JCB pode preferir que a plataforma seja o comerciante da liquidação. Em outros, pode solicitar que as contas conectadas exerçam essa função. No primeiro caso, é necessário que as cobranças na plataforma sejam feitas sem on_behalf_of; no segundo, esse parâmetro é obrigatório.

Novas contas Connect

Se você está fazendo onboarding na Stripe, pretende usar o Connect e quer aceitar pagamentos JCB para contas Connect, envie um e-mail para japan-jcb-payments@stripe.com.

Plataformas Connect existentes

Acesso para contas nas quais a plataforma coleta pagamentos

Você precisará solicitar a inscrição na JCB em nome das suas contas conectadas.

Como inscrever novas contas

Quando criar a conta, você precisará solicitar a função jcb_payments, além de card_payments e transfers.

Exemplo de código Python:

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

Exemplo de URL do 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

Inscrever contas conectadas existentes

Você precisará solicitar jcb_payments usando a API Capabilities.

Exemplo de código Python:

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

Acesso de contas nas quais a Stripe coleta tarifas

Novas contas conectadas serão inscritas automaticamente na JCB.

As contas conectadas existentes precisarão solicitar a aprovação da JCB pelo Dashboard. Consulte "Ativar pagamentos JCB para contas Stripe estabelecidas no Japão".

As plataformas Connect não podem inscrever as contas conectadas nas quais a Stripe recolhe tarifas em nome delas. Em vez disso, elas devem informar diretamente aos proprietários das contas que eles precisam ativar a JCB no Dashboard.

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

Aprovada

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

Rejeitada

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 da 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 por meio da API Capabilities.

Exemplo de código Python:

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

Resultado da inscrição

Resposta da API Capabilities

Aprovada

status: "active"

Rejeitada

status: "inactive"

Não inscrita

status: "unrequested"

Decisão pendente

status: "pending"

Aceitação, integração e testes

Informaremos por e-mail o resultado da avaliação da JCB. Após a aprovação, você poderá começar a criar e testar sua integração. Para obter informações sobre a integração, consulte Integrar pagamentos JCB para contas Stripe estabelecidas no Japão.

Antes da conclusão do onboarding da JCB, você poderá experimentar todos os tipos de cobrança no modo de teste, mas não no modo de produção.

Plataformas que não são japonesas

Para permitir que as contas conectadas japonesas aceitem a JCB, primeiro entre em contato para ativar a função jcb_payments na sua plataforma. Em seguida, você poderá fornecer respostas sobre a integração da Stripe nas configurações regionais do Connect. Depois de enviar suas informações, você poderá começar a solicitar a função nas suas contas conectadas.

Se as suas contas conectadas forem estabelecidas no Japão, você não precisará da função jcb_payments para aceitar cartões JCB.

Outras informações