Integrar pagos con JCB para plataformas Connect y cuentas conectadas

Las plataformas Connect pueden permitir que sus cuentas conectadas establecidas en Japón acepten pagos con JCB.

El flujo de onboarding a JCB para las cuentas conectadas es diferente según la fecha de creación de la cuenta de la plataforma Connect y de la cuenta conectada.

Plataformas creadas después del 17-10-2024

Podrás empezar inmediatamente a aceptar tarjetas JCB, Diners Club y Discover en las cuentas conectadas creadas después del 16-12-2024. Históricamente, esto solo era posible para las tarjetas Visa, Mastercard y American Express, y JCB exigía una revisión adicional para estas marcas de tarjetas.

Aunque puedes empezar a aceptar estas tarjetas inmediatamente, JCB revisa automáticamente todas las cuentas. En algunos casos, JCB puede rechazar tu cuenta o solicitar información adicional sobre tu empresa o sobre ti.

Verificación del estado de la inscripción de las cuentas conectadas

Una vez que JCB haya tomado una decisión sobre la solicitud de la cuenta conectada, Stripe te notificará mediante un webhook. Cuando JCB haya aprobado o rechazado tu cuenta, Stripe te enviará el webhook capability.updated.

Si JCB necesita más información sobre la cuenta conectada, Stripe se pondrá en contacto contigo por correo electrónico. Hasta que JCB apruebe la cuenta conectada, Stripe pausará temporalmente la capacidad de la cuenta conectada para aceptar nuevos pagos con JCB. Todos los pagos con JCB que se procesaron antes de la pausa se reembolsarán automáticamente.

Plataformas creadas antes del 17-10-2024

Al crear la cuenta, deberás solicitar la funcionalidad jcb_payments. Si se produce un error al solicitar la funcionalidad, ponte en contacto con japan-jcb-payments@stripe.com.

Ejemplo Código Python: solicitud de la funcionalidad al crear una nueva cuenta

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

Ejemplo de URL de OAuth: solicitud de la funcionalidad al crear una nueva cuenta

​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

Ejemplo Código Python: solicitud de la funcionalidad en una cuenta conectada existente

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

Aprobación y rechazo

En algunos casos, JCB solicitará más información o que tú o tu cuenta conectada realicen acciones adicionales. Si ese es el caso, Stripe te notificará por correo electrónico.

Una vez que JCB haya tomado una decisión sobre la solicitud de tu cuenta, Stripe te notificará mediante un webhook. Cuando JCB haya aprobado o rechazado tu cuenta, Stripe te enviará el webhook capability.updated.

Resultado de la inscripción

Información del webhook

Aprobado

type: "capability.updated"
data.object.id: "jcb_payments"
data.object.status: "active"
account: El identificador de la cuenta conectada aprobada

Rechazado

type: "capability.updated"
data.object.id: "jcb_payments"
data.object.status: "inactive"
account: El identificador de la cuenta conectada rechazada

Decisión pendiente

type: "capability.updated"
data.object.id: "jcb_payments"
data.object.status: "pending"
account: El identificador de la cuenta conectada enviada para la inscripción

Verificación del estado de la inscripción de las cuentas conectadas

Para verificar el estado de la inscripción a JCB de tu cuenta conectada, puedes consultar el estado de la funcionalidad jcb_payments mediante la API Capabilities.

Ejemplo de código en Python:

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

Resultado de la inscripción

Respuesta desde la API Capabilities

Aprobado

status: "active"

Rechazado

status: "inactive"

No inscrito

status: "unrequested"

Decisión pendiente

status: "pending"

Plataformas fuera de Japón

Para permitir que tus cuentas conectadas en Japón acepten JCB, primero ponte en contacto para habilitar la funcionalidad jcb_payments en tu plataforma. A continuación, podrás proporcionar respuestas sobre la integración con Stripe en la configuración regional de Connect. Después de enviar tu información, podrás comenzar a solicitar la funcionalidad para tus cuentas conectadas.

Si tus cuentas conectadas no están en Japón, no necesitas la funcionalidad jcb_payments para aceptar tarjetas JCB.

Información adicional