Integrar pagos con JCB para plataformas Connect y cuentas conectadas

Las plataformas Connect puede permitir a las cuentas conectadas establecidas en Japón aceptar pagos con JCB.

Es posible que JCB tenga más directrices sobre los tipos de cargos que se prefieren o aceptan en una plataforma concreta. En algunos casos se podría preferir que la plataforma sea el comerciante a cargo del cobro, mientras que en otros casos se podría solicitar que las cuentas conectadas sean el comerciante a cargo del cobro. En el primer caso, es necesario que los cargos de la plataforma se efectúen sin el parámetro on_behalf_of, mientras que en el segundo caso es obligatorio usar dicho parámetro.

Cuentas Connect nuevas

Si estás haciendo el onboarding en Stripe, quieres usar Connect y aceptar pagos con JCB en las cuentas Connect, primero ponte en contacto con japan-jcb-payments@stripe.com.

Plataformas Connect existentes

Acceso para cuentas en las que la plataforma cobra comisiones

Tendrás que solicitar la inscripción en JCB en nombre de tu cuenta conectada.

Inscripción de nuevas cuentas

Tendrás que solicitar la funcionalidad jcb_payments cuando crees la cuenta, junto con card_payments y transfers.

Ejemplo de código de Python:

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

Ejemplo de URL de 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

Inscripción de cuentas conectadas existentes

Tendrás que solicitar jcb_payments mediante la API Capabilities.

Ejemplo de código de Python:

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

Acceso para cuentas en las que Stripe cobra comisiones

Las cuentas conectadas nuevas se inscribirán en JCB de forma automática.

Las cuentas conectadas que ya existan deberán solicitar la aprobación de JCB mediante el Dashboard. Consulta Cómo activar JCB para cuentas de Stripe establecidas en Japón.

Las plataformas Connect no pueden inscribir cuentas conectadas en las que Stripe cobre comisiones en su nombre, sino que deben ponerse en contacto con los titulares de las cuentas para informarles de que habiliten JCB desde el Dashboard.

Aprobación y rechazo

En algunos casos, JCB solicitará más información o que tu cuenta conectada o tú sigáis pasos adicionales. En ese caso, Stripe te avisará por correo electrónico.

Una vez que JCB haya tomado una decisión sobre la solicitud de tu cuenta, Stripe te avisará mediante un webhook.

Una vez que JCB haya aprobado o rechazado tu cuenta, Stripe te enviará el webhook capability.updated.

Resultado de la inscripción

Información del webhook

Aprobada

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

Rechazada

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 inscribirse

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

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

Ejemplo de código de Python:

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

Resultado de la inscripción

Respuesta de la API Capabilities

Aprobada

status: "active"

Rechazada

status: "inactive"

No inscrita

status: "unrequested"

Decisión pendiente

status: "pending"

Aceptación, integración y pruebas

Te informaremos del resultado de la evaluación de JCB por correo electrónico. Una vez que tengas la aprobación, podrás comenzar a crear y probar la integración. Para obtener información sobre la integración, consulta Integrar pagos con JCB para cuentas de Stripe establecidas en Japón.

Puedes probar todos los tipos de cargos en el modo de prueba antes de que se complete el onboarding de JCB, pero no podrás usarlos en el modo activo.

Plataformas no japonesas

Para permitir que tus cuentas conectadas de Japón acepten JCB, lo primero es contactarnos para habilitar la funcionalidad jcb_payments para tu plataforma. De este modo, podrás dar respuestas sobre tu integración de Stripe en tu configuración regional de Connect. Tras enviar tu información, podrás empezar 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