Pix por Biometria
O Pix por Biometria está disponível somente no ambiente Sandbox. Não há suporte em produção no momento.
O Pix por Biometria não está disponível para todas as contas e depende de habilitação prévia pela Marlim. Para verificar a elegibilidade da sua conta, entre em contato com o nosso time comercial.
O Pix por Biometria permite que o seu cliente pague com Pix confirmando com a biometria do aparelho (impressão digital ou reconhecimento facial), sem sair da sua jornada para abrir o app do banco. Ele é baseado na Jornada sem Redirecionamento do Open Finance Brasil.
Na primeira compra, o cliente vincula o aparelho à conta dele, no banco, uma única vez. Nas compras seguintes, ele confirma o pagamento só com a biometria. A experiência fica parecida com a de um cartão salvo, com o valor creditado na hora.
Na Marlim você não precisa construir telas de vínculo nem de confirmação. Basta criar um link de pagamento e enviar o cliente para ele. A jornada cuida do vínculo, da biometria e da confirmação, e devolve o resultado para a sua aplicação.
Como funciona
| Etapa | O que acontece |
|---|---|
| 1 | Primeira compra. O cliente escolhe o banco, autoriza no app do banco o vínculo do aparelho e o pagamento, e cadastra a biometria. |
| 2 | Compras seguintes. No mesmo aparelho, o cliente confirma o pagamento com a biometria, sem ir ao app do banco. |
| 3 | Liquidação imediata. O valor é creditado na conta recebedora em segundos, em qualquer dia e horário. |
Regras do vínculo
| Regra | Descrição |
|---|---|
| Aparelho | O vínculo vale para o aparelho e o navegador usados na primeira compra. Em outro aparelho, o cliente faz um novo vínculo. |
| Requisitos | Aparelho com biometria ativa e navegador com suporte a chaves de acesso (passkeys). |
| Limites | O banco do cliente define os limites de valor dos pagamentos sem redirecionamento. |
| Desvinculação | O cliente pode desfazer o vínculo a qualquer momento no app do banco. A próxima compra volta a passar pelo banco. |
Conceitos
| Conceito | Descrição |
|---|---|
| Link de pagamento | URL gerada pela Marlim onde o cliente faz o vínculo, quando necessário, e confirma o pagamento. Possui status próprio e data de expiração. |
| Vínculo | Associação entre o aparelho do cliente e a conta dele no banco, aprovada uma única vez. É ele que permite confirmar os pagamentos seguintes com biometria. |
| Pagamento | O Pix gerado pelo link. Possui valor e status próprios. |
Fluxo da integração
| Etapa | Quem executa | O que acontece |
|---|---|---|
| 1 | Sua aplicação | Cria o link de pagamento com o Criar Link. |
| 2 | Sua aplicação | Envia o cliente para a payment_url retornada (navegador ou WebView). |
| 3 | Cliente | Na primeira compra, faz o vínculo no banco. Nas seguintes, confirma com a biometria. |
| 4 | Marlim | Redireciona o cliente para a sua redirect_url e notifica o resultado no seu webhook. |
| 5 | Sua aplicação | Confirma o pagamento pelo webhook ou pelo Consultar Pagamento antes de liberar o pedido. |
Crie links e cancele pagamentos sempre a partir do seu servidor. Nunca exponha a sua api_key no navegador ou no aplicativo do cliente.
Se você precisa controlar toda a experiência (vínculo, biometria e confirmação) dentro do seu site ou app, a integração sem o link de pagamento está disponível sob consulta. Fale com o nosso time de Desenvolvimento.
Casos de uso
| Segmento | Exemplo |
|---|---|
| Varejo online | Checkout com Pix em um toque para clientes que compram com frequência. |
| Delivery e mobilidade | Pedidos e corridas pagos sem sair do app. |
| Carteiras digitais | Pix salvo na carteira, confirmado com biometria a cada uso. |
| Recargas e créditos | Compras de valor baixo e alta frequência. |
Boas práticas
| Prática | Como aplicar |
|---|---|
| Combine webhook e consulta | Use os webhooks como fonte principal de atualização e as consultas como contingência. |
| Guarde os IDs da Marlim | Salve o link_id e o payment_id junto do seu pedido. As consultas e ações são feitas por esses IDs. |
Envie o item_id | Informe o identificador do seu pedido no link. Ele volta nas consultas e nos webhooks e facilita a conciliação e o suporte. |
| Envie sempre o mesmo documento | Informe o CPF ou CNPJ do cliente em todas as compras. A jornada usa esse dado para reconhecer o vínculo. |
Libere o pedido só com paid | Entregue o produto ou serviço somente com o pagamento em paid. |
| Trate as rejeições pelo código | Use o code do erro, nunca o texto de detail, que é livre e varia por banco. |