PayZu OnboardingIntegração

Mostrar na sua página


Nesta páginaInstale o pacoteMonte a jornadaPrepare a página

Monte a jornada num iframe da sua página, a partir de um clique do cliente.

Instale o pacote

bash
npm install @payzu/onboarding-web

Monte a jornada

abertura.js
import { mount, requestMotionPermission } from '@payzu/onboarding-web'

document.querySelector('#abrir-conta').addEventListener('click', async () => {
  await requestMotionPermission()
  mount({
    container: document.querySelector('#abertura'),
    url: embedUrl, // veio do seu backend
    onEvent: (event) => {
      if (event.type === 'step') alternarTelaCheia(event.viewport === 'full')
      if (event.type === 'closed') pedirOutroLinkAoBackend(event.reason)
    },
  })
})

No iOS, peça a permissão dos sensores de movimento no clique, antes do iframe.

Os sensores são usados na captura do documento, e a permissão só pode ser pedida nesse clique.

Prepare a página

ItemRegra
AlturaO iframe ocupa o contêiner inteiro. Dê altura a ele: tela cheia no celular (height: 100dvh) e um cartão de altura fixa no computador, como 720px.
CSPSe a sua página tem Content-Security-Policy, inclua em frame-src a origem da embedUrl.
PermissõesO iframe sai com allow="camera; microphone; geolocation; autoplay; encrypted-media; fullscreen; accelerometer; gyroscope; magnetometer". A sua página não pode mandar Permissions-Policy que negue câmera, microfone ou sensores de movimento.
OrigemA embedUrl só abre na origem para a qual foi emitida.