NuPay no checkout da sua loja

1. O que é a NuPay

A NuPay é a carteira de pagamentos do Nubank para o comércio eletrônico. Em vez de digitar dados de cartão no seu checkout, o cliente escolhe NuPay, é levado ao aplicativo do Nubank, confirma com a própria senha e volta para a loja com o pedido aprovado.

No painel da Wake ela é um conector de pagamento como qualquer outro: tem grupo de pagamento, credenciais próprias e regras de exibição no checkout.

Além da compra única, a Wake agora também suporta:

• Salvar o método de pagamento NuPay — o cliente autoriza uma vez no app Nubank e a loja pode reutilizar essa autorização em compras futuras (one-click).
• Assinatura / recorrência — após salvar a autorização, cobranças periódicas (planos, mensalidades) são processadas automaticamente sem que o cliente precise ir ao app novamente.

Por que oferecer

• Alcance: mais de 100 milhões de clientes Nubank, sem cadastro novo na sua loja.
• Menos atrito: autenticação no app que o cliente já usa, sem formulário de cartão nem código por SMS.
• Três fontes de pagamento em um só botão: saldo da conta, crédito e limite adicional, conforme você habilitar.
• Confiança da marca: a tela de confirmação é a do próprio Nubank.
• One-click buy: clientes que já salvaram o método pagam em um clique nas próximas compras.
• Recorrência nativa: assinaturas e planos são cobrados automaticamente, sem redirecionamento a cada ciclo.

2. Como funciona

Compra única (fluxo padrão)

A Wake integra o modelo NuPay 2FA: o cliente autentica no app do Nubank a cada compra. Não exige autorização prévia do comprador.

1. O cliente escolhe NuPay no checkout. Aparece o cartão "Pague com NuPay", com as formas habilitadas, o valor a pagar e um resumo de três passos.
2. A Wake abre uma sessão na NuPay. A plataforma envia valor, itens do carrinho, CPF e formas habilitadas; a NuPay devolve o link de autenticação.
3. O cliente autentica no app. Escolhe ali como pagar — saldo, crédito ou limite adicional — e, no crédito, em quantas parcelas.
4. O cliente volta para a loja. A NuPay notifica a Wake e o status do pedido é atualizado sozinho. Se a notificação atrasar, uma rotina da plataforma consulta o status e conclui o pedido.

Salvar método / One-click (fluxo CIBA) 

O fluxo de autorização prévia usa o protocolo CIBA (Client Initiated Backchannel Authentication): o cliente solicita autorização no backend, o cliente é aprovado pelo app Nubank uma única vez, e a Wake guarda essa autorização para uso em cobranças futuras.

Na etapa de pagamento, o cliente vê a opção "Salvar meu NuPay para compras futuras".

O cliente confirma no app Nubank — uma notificação push aparece pedindo autorização. Nesse momento, o cliente escolhe o método de pagamento (saldo da conta, limite adicional ou crédito) que ficará associado à autorização salva.

A Wake salva a autorização de forma segura. Nas próximas compras, o NuPay aparece como método salvo e o cliente finaliza sem precisar abrir o app novamente.

O método salvo é universal: uma vez que o cliente autoriza o NuPay, essa autorização fica disponível tanto para compras avulsas (one-click) quanto para assinaturas — e o método de pagamento associado é sempre o escolhido no momento da autorização inicial. Por exemplo: se o cliente autorizou com saldo da conta (débito), tanto as compras avulsas futuras quanto eventuais assinaturas contratadas na mesma loja usarão o saldo da conta. Não é necessário autorizar novamente ao contratar uma assinatura se o NuPay já estiver salvo.

Assinatura / recorrência (fluxo CIBA) 

Para produtos de assinatura, o fluxo de autorização inicial é feito uma única vez no momento da contratação. As cobranças recorrentes subsequentes (mensalidades, renovações) são processadas automaticamente pela Wake usando a autorização já salva — sem redirecionamento, sem interação adicional do cliente.

As três formas do conector

Onde as parcelas são escolhidas: o checkout da sua loja não mostra a lista de parcelas. A plataforma envia as opções e é o app do Nubank que as apresenta, inclusive juros do Nubank. O pedido fecha  na Wake e, se o valor ou as parcelas cobradas divergirem, a plataforma ajusta o pagamento ao receber a confirmação.

3. Quem pode habilitar

Requisito obrigatório: somente lojas em Storefront 2.0. O cartão de pagamento é montado pelo conector e renderizado pelo checkout do Storefront 2.0 — no checkout anterior a forma não é exibida e não há como habilitá-la.

Além disso, você precisa de:

• Cadastro aprovado na NuPay for Business — contrato direto entre sua empresa e o Nubank; a Wake não intermedia a aprovação comercial.
• As credenciais de sandbox e de produção entregues pela NuPay ao fim do cadastro.
• Os IPs de saída da plataforma liberados no cadastro da NuPay — as credenciais ficam vinculadas aos IPs informados. Peça essa lista ao seu atendimento antes de preencher o formulário da NuPay.
• Um grupo de pagamento próprio para a NuPay, com parcelamento configurado caso você vá habilitar a forma Crédito.

Requisitos adicionais para salvar método / recorrência 

Para habilitar one-click e assinatura, você precisará também de:

• Client ID — emitido pela NuPay for Business após o cadastro do fluxo CIBA. Solicite ao seu contato comercial da NuPay.
• Par de chaves JWK (Client ID + chave privada) — gerado pela sua empresa e registrado na NuPay. Veja o passo a passo na seção 4.
• Produto de assinatura configurado na Wake — para cobranças recorrentes, o produto precisa ter o tipo "assinatura" habilitado.

Atenção: se a loja usa split de pedido: se o carrinho tem produtos de centros de distribuição diferentes e a configuração "Transação única no split" está desativada, a NuPay é removida da lista de formas de pagamento. Para oferecê-la nesse cenário, a transação única precisa estar ativada.
 

4. Credenciais: o que é cada uma e como consegui-las

Todas as chaves são emitidas pela NuPay ou geradas pela sua empresa. Você recebe dois conjuntos de credenciais — um de sandbox e um de produção — e eles não são intercambiáveis.

Merchant Key e Merchant Token

É o par que identifica e autentica sua loja em cada chamada de compra única. São entregues ao final do cadastro da loja na NuPay for Business, pelo canal de onboarding do Nubank. Se você não os tem, solicite ao seu contato comercial da NuPay — não ao suporte da Wake.

Client ID e chave privada — obrigatórios para one-click e assinatura

Usados pelo modelo de autorização prévia (CIBA), que habilita salvar o método de pagamento e cobranças recorrentes. Para configurar:

1. Gere um par de chaves JWK em mkjwk.org com os parâmetros: kty: EC, use: sig, alg: ES256, crv: P-256. O site devolve a chave pública (x, y), a privada (d) e um identificador (kid).
2. Envie apenas a chave pública à NuPay pelo formulário oficial de cadastro. Antes de enviar, remova a propriedade "d" — ela é sua chave privada e não deve sair da empresa.
3. Receba o Client ID por e-mail da NuPay for Business. Ele complementa a Merchant Key e o Merchant Token; não substitui nenhum dos dois.
4. Guarde a chave privada completa (o JSON com o "d") para cadastrar no conector da Wake.

Cuidados com as chaves

• Acesso apenas a perfis de administrador ou desenvolvedor.
• Nunca em repositório de código, arquivo de front-end ou planilha compartilhada.
• Não envie por WhatsApp, chat ou e-mail sem proteção — nem para o suporte.
• Chave de produção que vazou precisa ser substituída junto à NuPay, não só trocada no painel.

5. Como configurar na Wake

Configuração básica (compra única)

1.Crie a configuração do conector NuPay em Configurações → Meios de pagamento, com um nome que identifique o ambiente.

2.Preencha as credenciais fornecidas pelo time Nupay

3.Escolha as formas de pagamento e os percentuais de desconto. Só o que estiver ativo é enviado à NuPay e exibido no checkout.

3.Defina os tempos e o comportamento de recusa (Checkout online e Não cancelar pedidos recusados).

5.Crie o grupo de pagamento da NuPay. Se você vai habilitar Crédito, é aqui que o parcelamento é configurado — o conector não tem campo de parcelas.

6.Teste em sandbox de ponta a ponta com cada forma habilitada

7.Vire para produção: troque as credenciais, desative o Sandbox, vincule o grupo à loja e faça um pedido real de valor baixo antes de anunciar.

Configuração adicional para one-click e assinatura 

Após a configuração básica:

8.Preencha o Client ID no campo correspondente do conector.

9.Cole a chave privada JWK (o JSON completo, incluindo o campo "d") no campo de chave privada.

10.Habilite a opção "Salvar método de pagamento" no conector para liberar o one-click no checkout.

11.Para assinatura: certifique-se de que o produto está configurado como assinatura e que a loja tem a funcionalidade de recorrência ativa.

12.Teste o fluxo completo em sandbox: autorização inicial → compra com método salvo → cobrança recorrente (se aplicável).

6. O que é cada campo da configuração

Observação:  Caso o CPF do comprador não seja elegível ou a NuPay não retorne condições de pagamento, será exibida a seguinte mensagem na tela para o cliente, orientando a troca da forma de pagamento:

"Não foi possível finalizar com NuPay. Selecione outro método de pagamento para concluir sua compra."

7. O que não é suportado

• Não compatível com transação única desativada
• Não disponível para checkout storefront versão 1.0

8. Dúvidas frequentes

Clique aqui.