Passar para o conte
PAGAMENTOS · Pagamentos Online

A sua finalização de compra.
Uma forma mais clara de pagar.

Transforme uma encomenda online numa jornada simples de pagamento. Conecte o seu website ao NeroPay, envie os clientes para a finalização de compra alojada e traga o resultado de volta para o fluxo de trabalho da sua empresa.

✓ Finalização de compra no website✓ API v2✓ Página de pagamento alojada

Desenvolvido para o seu website ou aplicação. Prefere um pedido pronto a partilhar? Explore antes os Pagamentos por Link.

Finalização de compra alojada · API v2Pré-visualização
POST /v2/hosted-payments
{
  "identifier": "ORDER-1001",
  "amount": 15.99,
  "currency": "GBP",
  "details": "Online order",
  "ipn_url": "https://example.com/payments/ipn",
  "success_url": "https://example.com/order/thank-you",
  "cancel_url": "https://example.com/order/cancelled",
  "customer_name": "Customer",
  "customer_email": "customer@example.com"
}
Encomenda ENCOMENDA-1001Cliente continua para finalização de compra alojada
£15.99
O SEU SERVIDOR→FINALIZAÇÃO DE COMPRA ALOJADA→RESULTADO DO PAGAMENTO
A resposta inicial cria um URL de checkout. Não confirma o pagamento.
Para os seus clientesUm valor claro e um checkout alojado.
Para os seus desenvolvedoresUm pedido único de API para criar a página de pagamento.
Para o seu negócioAcompanhe o resultado, não apenas o clique.
PAGAMENTOS ALÉM DO BALCÃO

Venda online. Mantenha a jornada conectada.

Ofereça aos clientes uma forma simples de pagar sem construir um fluxo de introdução de cartão no seu próprio site.

Um checkout que se adapta ao seu site

Mantenha a sua própria cesta e experiência de encomenda. Crie uma página de pagamento quando o cliente estiver pronto e depois redirecione-o para NeroPay.

A introdução do cartão permanece no checkout alojado

Sua integração envia informações da encomenda e do cliente — não os dados brutos do cartão. A sua chave secreta de API permanece no seu servidor.

Traga o resultado de volta ao seu fluxo de trabalho

Use uma referência única da encomenda e o seu ponto de extremidade de notificação de pagamento para conectar o resultado do pagamento à encomenda que o originou.

DA CESTA AO PAGAMENTO

Um caminho simples da encomenda ao checkout.

O seu site mantém a lógica da encomenda. NeroPay fornece a etapa do pagamento alojado. O seu servidor confirma o resultado antes de efetuar o pedido.

1

Crie a encomenda

Guarde o total da cesta, os detalhes do cliente e a sua referência única. Mantenha o montante final controlado pelo seu servidor.

2

Crie o checkout alojado

Envie o pedido do seu servidor para a API v2 e direcione o cliente para o URL de checkout retornado.

3

Confirmar e cumprir

Gerencie o resultado do pagamento no servidor, concilie-o com seu pedido e processe o cumprimento apenas uma vez.

EXPLORAR O FLUXO

Veja o próximo passo.

Pedido salvo

Mantenha o carrinho no seu site.

Seu servidor calcula o valor a pagar e salva a referência do pedido antes da criação do checkout.

Jornada do cliente£15.99
PARA SEU DESENVOLVEDOR

Sua lógica de pedidos.
Nosso checkout hospedado.

Crie a página de pagamento a partir do seu servidor. Envie o cliente para a URL do checkout retornada e depois use resultados de pagamento verificados para atualizar o pedido.

01
Uma integração do lado do servidor

O exemplo usa a API v2 e unidades monetárias principais: 15.99 significa £15.99 em GBP.

02
Autenticado e assinado

Mantenha a chave secreta no seu servidor. Assine o corpo JSON exato que enviar usando um carimbo de tempo recente.

03
Tente novamente sem criar um novo pedido

Persista o payload e a chave de idempotência com seu pedido. Reutilize ambos apenas para uma tentativa exata daquela requisição.

04
Cumprir uma vez, após confirmação

Verifique o resultado do pagamento e confirme a referência, montante e moeda antes de atualizar a sua encomenda.

Este é um exemplo de criação no lado do servidor—não uma integração completa para produção. Adicione a persistência da sua encomenda, tratamento verificado de notificações, gestão de erros e reconciliação.

POST Exemplo de checkout no lado do servidor
// Server-side only · Node.js 18+
import { createHmac } from 'node:crypto';

const secret = process.env.NEROPAY_SECRET_API_KEY;
if (!secret) throw new Error('Missing API secret');

// Store this payload and key with the order before sending.
// Retry the exact same payload with the same idempotency key.
const payload = {
  "identifier": "ORDER-1001",
  "amount": 15.99,
  "currency": "GBP",
  "details": "Online order",
  "ipn_url": "https://example.com/payments/ipn",
  "success_url": "https://example.com/order/thank-you",
  "cancel_url": "https://example.com/order/cancelled",
  "customer_name": "Customer",
  "customer_email": "customer@example.com"
};
const rawBody = JSON.stringify(payload);
const timestamp = String(Math.floor(Date.now() / 1000));
const signature = createHmac('sha256', secret)
  .update(timestamp + '.' + rawBody)
  .digest('hex');

const response = await fetch(
  'https://eu.neropay.app/v2/hosted-payments',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer ' + secret,
      'Accept': 'application/json',
      'Content-Type': 'application/json',
      'X-NeroPay-Timestamp': timestamp,
      'X-NeroPay-Signature': signature,
      'Idempotency-Key': 'hosted-order-1001-v1'
    },
    body: rawBody
  }
);

const result = await response.json();
if (!response.ok || !result.success) {
  throw new Error('Could not create checkout');
}

// Send this URL to the customer; do not mark the order paid here.
const checkoutUrl = result.data.checkout_url;
// Fulfil only after a verified server-side payment result.

Substitua o cliente de exemplo e as URLs pelos dados da sua encomenda e pelos seus endpoints. Nunca coloque o seu segredo da API no HTML da página ou no JavaScript do lado do cliente.

DESENVOLVIDO PARA VENDAS REAIS

Mais do que uma forma de vender online.

Escolha o método de pagamento online que corresponde à forma como os clientes encomendam à sua empresa.

Encomendas no website

Use o seu carrinho existente e envie os clientes para uma página de pagamento hospedada para o passo final do checkout.

Marcações e depósitos

Construa um checkout em torno de um montante de reserva acordado e ligue a referência de pagamento à reserva.

Portais personalizados para clientes

Adicione um passo de pagamento a uma conta de cliente, ordem de serviço ou fluxo de trabalho business-to-business.

O SEU WEBSITE, A SUA LÓGICA DE ENCOMENDA

Mantenha as decisões onde pertencem.

Uma integração fiável começa com uma divisão clara de responsabilidades. O seu website define a encomenda; o sistema de pagamento confirma se foi paga.

Valide o total no seu servidor

Não confie no preço fornecido pelo navegador ou numa referência de encomenda editada pelo cliente.

Mantenha as credenciais fora do navegador

A sua chave secreta, assinatura de pedidos e verificações do resultado do pagamento pertencem ao seu servidor.

Trate um redirecionamento como navegação—não como prova

Um cliente que chega à sua página de agradecimento não confirma, por si só, um pagamento bem-sucedido.

A FERRAMENTA CERTA PARA O PEDIDO

Uma conta. Mais formas de receber pagamentos.

Escolha o método que corresponde à forma como seu cliente compra — não um caminho de pagamento único para todos.

PARTE DE UM NEGÓCIO CONECTADO

Os pagamentos são só o começo.

Explore as ferramentas NeroPay que se adaptam à forma como seu negócio atende os clientes — online, por marcação ou no balcão.

NeroWeb

Menus e pedidos online
Leve a experiência de encomenda de comida para o online e mantenha os pagamentos parte do percurso do cliente.

Explore NeroWeb →

NeroBooking

Reservas e atendimento ao cliente
Mantenha a informação da reserva próxima do restante do seu negócio e escolha o pedido de pagamento certo para cada serviço.

Explore NeroBooking →

NeroPOS

No balcão e além
Ligue o seu serviço presencial com a experiência mais ampla NeroPay, desde encomendas na caixa até pagamentos suportados por cartão.

Explore NeroPOS →
O software NeroPOS, NeroWeb e NeroBooking é gratuito quando utiliza pagamentos NeroPay. O processamento de pagamentos, hardware e quaisquer serviços opcionais têm preços e termos aplicáveis próprios. Ver preços →
AS SUAS PERGUNTAS, RESPONDIDAS

Pagamentos Online.
Os detalhes úteis.

Precisa de ajuda para escolher a configuração certa para o seu negócio? A nossa equipa pode orientar-lo nas opções.

Fale com NeroPay →

Referência oficial da API v2 ↗

Preciso criar o meu próprio formulário de pagamento com cartão?

Não. A API cria uma página de pagamento alojada em NeroPay. O seu site controla o carrinho e redireciona o cliente para o checkout; os dados do cartão são inseridos na página alojada.

Preciso de um programador para ligar um site existente?

Uma integração personalizada da API normalmente precisa de um programador. Se não necessita de um carrinho personalizado, Link Payments, Invoice Payments e NeroForm oferecem outras formas de solicitar pagamento.

Onde posso encontrar a referência da API?

A referência da API NeroPay v2 contém os campos de requisição, detalhes de autenticação, exemplos e orientações para notificações de pagamento. Use a referência mais recente ao construir a sua integração.

Como deve o meu site confirmar se uma encomenda está paga?

Utilize um resultado de pagamento verificado no servidor e corresponda-o à referência e montante da encomenda. Não cumpra apenas porque a página de checkout foi aberta ou o cliente voltou a uma URL de sucesso.

Pagamentos online e presenciais podem usar a mesma conta NeroPay?

Sim. A sua conta NeroPay pode suportar ferramentas de pagamento online juntamente com o seu sistema de pagamento presencial ativado. Os métodos disponíveis e os requisitos da conta dependem do seu negócio e região.

O que significa o montante no exemplo da API?

O exemplo usa unidades principais da moeda: 15.99 significa £15.99 quando a moeda é GBP. Siga sempre o formato do montante documentado no endpoint.

Onde posso verificar taxas e detalhes de liquidação?

Consulte os preços atuais de NeroPay e os termos da sua conta. Um pagamento de cliente bem-sucedido e a disponibilização dos fundos para pagamento são estágios separados; não prometa disponibilidade imediata a partir da resposta do checkout.

Dê ao seu site uma experiência de pagamento que vale a pena concluir.

Explore o checkout alojado, consulte a referência da API e escolha a configuração de pagamento online correta para o seu negócio.