Pular para o conteúdo principal

Pix por Biometria

Disponível apenas em Sandbox

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​

EtapaO que acontece
1Primeira compra. O cliente escolhe o banco, autoriza no app do banco o vínculo do aparelho e o pagamento, e cadastra a biometria.
2Compras seguintes. No mesmo aparelho, o cliente confirma o pagamento com a biometria, sem ir ao app do banco.
3Liquidação imediata. O valor é creditado na conta recebedora em segundos, em qualquer dia e horário.

Regras do vínculo​

RegraDescrição
AparelhoO vínculo vale para o aparelho e o navegador usados na primeira compra. Em outro aparelho, o cliente faz um novo vínculo.
RequisitosAparelho com biometria ativa e navegador com suporte a chaves de acesso (passkeys).
LimitesO banco do cliente define os limites de valor dos pagamentos sem redirecionamento.
DesvinculaçãoO cliente pode desfazer o vínculo a qualquer momento no app do banco. A próxima compra volta a passar pelo banco.

Conceitos​

ConceitoDescrição
Link de pagamentoURL 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ínculoAssociaçã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.
PagamentoO Pix gerado pelo link. Possui valor e status próprios.

Fluxo da integração​

EtapaQuem executaO que acontece
1Sua aplicaçãoCria o link de pagamento com o Criar Link.
2Sua aplicaçãoEnvia o cliente para a payment_url retornada (navegador ou WebView).
3ClienteNa primeira compra, faz o vínculo no banco. Nas seguintes, confirma com a biometria.
4MarlimRedireciona o cliente para a sua redirect_url e notifica o resultado no seu webhook.
5Sua aplicaçãoConfirma o pagamento pelo webhook ou pelo Consultar Pagamento antes de liberar o pedido.
Atenção

Crie links e cancele pagamentos sempre a partir do seu servidor. Nunca exponha a sua api_key no navegador ou no aplicativo do cliente.

Modalidade "Sua Interface"

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​

SegmentoExemplo
Varejo onlineCheckout com Pix em um toque para clientes que compram com frequência.
Delivery e mobilidadePedidos e corridas pagos sem sair do app.
Carteiras digitaisPix salvo na carteira, confirmado com biometria a cada uso.
Recargas e créditosCompras de valor baixo e alta frequência.

Boas práticas​

PráticaComo aplicar
Combine webhook e consultaUse os webhooks como fonte principal de atualização e as consultas como contingência.
Guarde os IDs da MarlimSalve 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_idInforme 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 documentoInforme 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 paidEntregue o produto ou serviço somente com o pagamento em paid.
Trate as rejeições pelo códigoUse o code do erro, nunca o texto de detail, que é livre e varia por banco.