# PIX por biometria Com um [Pedido de Pagamento](/docs/payments/overview) regular, o pagador é redirecionado para seu banco a cada pagamento para aprová-lo. Com **PIX por biometria**, o pagador vai ao banco apenas uma vez, para vincular uma conta ao seu dispositivo. A partir de então, ele confirma cada pagamento na página de pagamento da Pluggy com Face ID, sua impressão digital ou o bloqueio de tela do dispositivo, sem sair da página. PIX por biometria é a *Jornada Sem Redirecionamento* (JSR) do Open Finance. O pagamento ainda é um Pix iniciado através do Open Finance: ele é liquidado instantaneamente, e você o rastreia com os mesmos Pedidos de Pagamento, Intenções de Pagamento e webhooks que já utiliza. Leia a [Visão Geral dos Pagamentos](/docs/payments/overview) primeiro. O PIX por biometria se baseia nos mesmos destinatários, pedidos de pagamento e intenções de pagamento. ## Como funciona ### O primeiro pagamento em um dispositivo 1. O pagador abre o `paymentUrl` e escolhe seu banco. Apenas instituições que suportam vinculação estão listadas. 2. A página explica o que significa vinculação, e o pagador é redirecionado para o banco. Lá, ele aprova o vínculo e define seus limites. Ele tem até 15 minutos para fazer isso. 3. De volta à página de pagamento, o pagador cria uma chave de acesso com as biometria ou bloqueio de tela do dispositivo. Isso completa o vínculo. 4. O pagador confirma o pagamento com biometria, e o Pix é enviado. ### Cada pagamento posterior No mesmo dispositivo e navegador, a página de pagamento encontra a conta vinculada do pagador e a exibe ao lado dos detalhes do pagamento. O pagador confirma com biometria e o pagamento é enviado. Não há redirecionamento para o banco. O pagador também pode optar por pagar com outro banco, o que inicia o caminho do primeiro pagamento para essa instituição. ## Conceitos - **Pedido de Pagamento**: um por compra, criado com `POST /payments/requests/pix-biometric`. Você envia seu `paymentUrl` para o pagador, como em qualquer pedido de pagamento. - **Intenção de Pagamento**: cada tentativa de pagar um pedido. As intenções de PIX por biometria têm `paymentMethod: "PIX_BIOMETRIC"` e um `enrollmentId`. Apenas a página de pagamento as cria. - **Vinculação**: a conta vinculada. Ela liga a conta do pagador em uma instituição a um dispositivo e navegador. Apenas o pagador pode criá-la, na página de pagamento. Você pode listar, ler e revogar vinculações através da API. Veja [Gerenciando contas vinculadas](/docs/payments/pix-biometric-enrollments). ## Comparado a um pedido de pagamento regular | | Pedido de Pagamento | PIX por biometria | |---|---|---| | Redirecionamento do banco | A cada pagamento | Apenas no primeiro pagamento em um dispositivo, para vincular a conta | | Onde o pagador confirma | No aplicativo ou site do banco | Na página de pagamento da Pluggy, com biometria | | Experiência de pagamento | Página de pagamento da Pluggy, ou sua própria UI através da API de Intenções de Pagamento | Apenas página de pagamento da Pluggy | | Pagamentos agendados | Suportados ([Pix Agendado](/docs/payments/scheduled-payments)) | Não suportados: apenas pagamentos únicos | | Sandbox | Disponível | Em desenvolvimento | ## Requisitos e limites - **Iniciação de Pagamento** deve estar habilitada para seu cliente. - **Instituições**: a instituição deve suportar vinculação. Verifique `supportsPixBiometric` no conector (veja [Cobertura](/docs/payments/coverage)). - **Dispositivo**: o pagador precisa de biometria ou bloqueio de tela e um navegador que suporte chaves de acesso. Alguns navegadores embutidos em aplicativos não podem usar chaves de acesso; quando a página detecta um, ela pede ao pagador para abrir o link no navegador do dispositivo. - **Um vínculo por dispositivo**: um vínculo pertence ao dispositivo e navegador onde a chave de acesso foi criada, ao CPF ou CNPJ do pagador, e ao seu cliente. Em outro dispositivo ou navegador, o pagador vincula novamente, o que cria uma nova vinculação. - **Limites**: ao vincular, o pagador define um limite por pagamento e um limite diário no banco. A instituição rejeita um pagamento acima deles. O campo `limits` da vinculação os mostra. - **Expiração**: cada vínculo tem uma data de expiração definida pela instituição (`expiresAt`). Após isso, o pagador vincula novamente. - **Destinatários**: os pagamentos vão para destinatários de contas bancárias. Destinatários de contas inteligentes não são suportados. ## Compartilhando saldo (opcional) Crie o pedido de pagamento com `linkedJourney: true` para permitir que o pagador também compartilhe seu saldo de conta e limite de cheque especial com você ao vincular, na mesma aprovação no banco. O compartilhamento é opcional para o pagador e desmarcado por padrão. Dura enquanto o vínculo, e você lê o saldo através da API antes de cobrar, para evitar pagamentos rejeitados por fundos insuficientes. Veja [Gerenciando contas vinculadas](/docs/payments/pix-biometric-enrollments#sharing-balance). ## Desvinculação O pagador pode desfazer um vínculo a qualquer momento no aplicativo do banco. Você pode revogar um vínculo através da API. De qualquer forma, o próximo pagamento nesse dispositivo passa pelo banco novamente para criar um novo vínculo. Veja [Introdução ao PIX por biometria](/docs/payments/pix-biometric-getting-started) para criar seu primeiro pedido de pagamento.