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.

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.

2. Como funciona

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.

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.
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.
O cliente autentica no app. Escolhe ali como pagar — saldo, crédito ou limite adicional — e, no crédito, em quantas parcelas.
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.

As três formas do conector

Saldo da conta (ativo por padrão) — débito no saldo do Nubank, à vista.
Limite adicional (ativo por padrão) — crédito extra concedido pelo Nubank para aquela compra.
Crédito (desativado por padrão) — crédito parcelado; exige parcelamento configurado no grupo de pagamento da NuPay.

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 em 1x 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.

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, nunca pela Wake. Você recebe dois conjuntos — 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. 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 (fora do escopo atual)

Usadas apenas pelo modelo pré-autorizado da NuPay, que não faz parte desta entrega. Deixe os campos em branco. Quando o pré-autorizado for liberado, o caminho é:

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).
Envie só 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.
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.
Guarde a chave privada completa (o JSON com o "d") para cadastrar no conector.

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

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.
Crie a configuração do conector NuPay em Configurações → Meios de pagamento, com um nome que identifique o ambiente.
Preencha as credenciais de teste e mantenha Sandbox ativado. Credencial de produção com Sandbox ativado não funciona, e o contrário também não.
Escolha as formas de pagamento e os percentuais de desconto. Só o que estiver ativo é enviado à NuPay e exibido no checkout.
Defina os tempos e o comportamento de recusa (Checkout online e Não cancelar pedidos recusados).
Teste em sandbox de ponta a ponta com cada forma habilitada, e também com conta corrente, cupom e split se a loja usa esses recursos.
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.

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

Campo	O que é e o que preencher
Merchant Key	Identifica sua loja nas chamadas à NuPay. Entregue pela NuPay ao concluir o cadastro — um valor para sandbox, outro para produção.
Merchant Token	Autentica as chamadas, sempre em par com a Merchant Key. Entregue junto, no mesmo par por ambiente.
Client ID	Usado só no modelo pré-autorizado, fora do escopo atual. Deixe em branco.
Chave privada	Chave JWK do modelo pré-autorizado, fora do escopo atual. Deixe em branco.
Sandbox	Alterna entre ambiente de teste e produção da NuPay. Precisa combinar com o par de credenciais preenchido.
Débito / Saldo da conta	Exibe o pagamento com saldo da conta Nubank. Já vem ativado.
% de desconto no débito	Desconto sobre o valor enviado à NuPay nessa forma. Número positivo; 0 = sem desconto.
Limite adicional	Exibe o crédito extra concedido pelo Nubank para aquela compra. Já vem ativado.
% de desconto no limite adicional	Desconto sobre o valor enviado à NuPay nessa forma. Número positivo; 0 = sem desconto.
Crédito	Exibe o crédito parcelado. Vem desativado — antes de ativar, configure o parcelamento no grupo de pagamento da NuPay.
Tempo de expiração da sessão	Minutos que o cliente tem para concluir no app. Em branco = padrão NuPay de 30 minutos.
Tempo limite de aprovação	Minutos que a NuPay espera pela aprovação antes de cancelar. Em branco = padrão NuPay de 30 minutos.
Checkout online	Mostra a recusa da NuPay ao cliente ainda na tela de pagamento. Vem desativado.
Não cancelar pedidos recusados	Mantém o pedido em "aguardando pagamento" quando a NuPay recusa, em vez de cancelar. Vem desativado.

A combinação que mais muda a experiência: quando o CPF do comprador não é elegível para a NuPay, o resultado depende das duas últimas chaves. Com Checkout online ativado e Não cancelar pedidos recusados desativado, o cliente vê o erro no checkout e o pedido nasce cancelado. Com Checkout online desativado e Não cancelar pedidos recusados ativado, o pedido é criado e fica aguardando pagamento, mesmo recusado pela NuPay.

7. Compatibilidades

Já testado e funcionando:

Conta corrente — o saldo é descontado e o restante vai para a NuPay. Se o saldo cobre o total, o pedido nasce pago sem passar pela NuPay.
Cupom de desconto — aplicado antes do valor ser enviado à NuPay.
Troca de forma de pagamento — um pedido aguardando pagamento pode ser trocado para NuPay, nas três formas.
Split de pedido com transação única ativada — pedidos filhos são gerados e todos ficam pagos.
Sessão expirada sem pagamento — o pedido é cancelado mesmo sem notificação da NuPay.

8. O que não é suportado

Recurso	Origem	O que acontece
Assinatura / recorrência	Escopo da entrega	Com pelo menos 1 produto de assinatura no carrinho, a NuPay não é exibida (mesma regra do Apple Pay).
Cartões salvos / one-click	Escopo da entrega	O formulário da NuPay não sugere cartões salvos do cliente.
Modelo pré-autorizado	Escopo da entrega	Só o 2FA está disponível: há redirecionamento ao app em toda compra.
Antifraude no conector	Escopo da entrega	Não funciona com a NuPay.
Parcelas no checkout	Definição de produto	A escolha de parcelas é feita no app do Nubank. Juros ou não dependerá da configuração de parcelamento.

9. Estornos e acompanhamento

Estornos totais ou parciais são feitos pela API pública da Wake, no endpoint de estorno de pedido. A NuPay valida o valor e recusa tentativas acima do total do pedido.

Para acompanhar as vendas: o ícone da NuPay identifica os pedidos no painel, e nos relatórios de aprovação por adquirente a NuPay entra como adquirente próprio, permitindo comparar a taxa de aprovação com os seus outros meios de pagamento.

10. Dúvidas frequentes

Clique aqui.

Pesquisa