PayZu OnboardingIntegração
Mostrar na sua 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-webMonte 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
| Item | Regra |
|---|---|
| Altura | O 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. |
| CSP | Se a sua página tem Content-Security-Policy, inclua em frame-src a origem da embedUrl. |
| Permissões | O 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. |
| Origem | A embedUrl só abre na origem para a qual foi emitida. |