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.
Desenvolvido para o seu website ou aplicação. Prefere um pedido pronto a partilhar? Explore antes os Pagamentos por Link.
{
"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"
}{
"success": true,
"data": {
"identifier": "ORDER-1001",
"status": "pending",
"amount": 15.99,
"currency": "GBP",
"checkout_url": "https://eu.neropay.app/initiate/payment/checkout?payment_id=..."
}
}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.
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.
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.
Crie o checkout alojado
Envie o pedido do seu servidor para a API v2 e direcione o cliente para o URL de checkout retornado.
Confirmar e cumprir
Gerencie o resultado do pagamento no servidor, concilie-o com seu pedido e processe o cumprimento apenas uma vez.
Veja o próximo passo.
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.
O cliente paga na página de pagamento.
Sua integração envia o cliente para a URL do checkout retornada. A abertura do checkout não é prova de pagamento.
Confirme o pagamento antes do cumprimento.
Associe um resultado de pagamento verificado à referência do pedido e ao valor. Trate notificações repetidas sem cumprir duas vezes.
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.
O exemplo usa a API v2 e unidades monetárias principais: 15.99 significa £15.99 em GBP.
Mantenha a chave secreta no seu servidor. Assine o corpo JSON exato que enviar usando um carimbo de tempo recente.
Persista o payload e a chave de idempotência com seu pedido. Reutilize ambos apenas para uma tentativa exata daquela requisiçã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.
// 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.
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.
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.
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.
Pagamentos Online
Crie um checkout para website.
Você está aquiPagamentos por Link
Solicite um valor específico.
Explore Pagamentos por Link →Pagamentos por Fatura
Fature com detalhes discriminados.
Explore os Pagamentos de Faturas →NeroForm
Deixe seu cliente escolher o valor.
Explore NeroForm →Contratos
Junte acordo e pagamento.
Explore Contratos →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.
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.
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.
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 →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.
As funcionalidades disponíveis, métodos de pagamento, elegibilidade, taxas e condições de liquidação dependem da sua conta, negócio e região. Ver preços atuais · Contacte-nos