PIX por biometria

Com um Pedido de Pagamento 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.

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.

Comparado a um pedido de pagamento regular#

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).
• 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.

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 para criar seu primeiro pedido de pagamento.