Il tuo checkout.
Un modo più chiaro di pagare.
Trasforma un ordine online in un percorso di pagamento semplice. Collega il tuo sito web a NeroPay, indirizza i clienti al checkout ospitato e integra poi il risultato nel flusso di lavoro della tua attività.
Realizzato per il tuo sito o applicazione. Preferisci una richiesta pronta da condividere? Esplora invece i Link 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"
}{
"success": true,
"data": {
"identifier": "ORDER-1001",
"status": "pending",
"amount": 15.99,
"currency": "GBP",
"checkout_url": "https://eu.neropay.app/initiate/payment/checkout?payment_id=..."
}
}Vendi online. Mantieni il percorso connesso.
Offri ai clienti un modo semplice per pagare senza dover creare un flusso di inserimento carta nel tuo sito.
Un checkout che si adatta al tuo sito
Mantieni il tuo carrello e l’esperienza d’ordine. Crea una pagina di pagamento quando il cliente è pronto, poi reindirizzalo a NeroPay.
L’inserimento della carta rimane nel checkout ospitato
La tua integrazione invia informazioni sull’ordine e sul cliente, non i dati grezzi della carta. La tua chiave API segreta resta sul tuo server.
Riporta il risultato nel tuo flusso di lavoro
Usa un riferimento ordine unico e il tuo endpoint di notifica di pagamento per collegare l’esito del pagamento con l’ordine che lo ha generato.
Un percorso semplice dall’ordine al checkout.
Il tuo sito mantiene la logica dell’ordine. NeroPay fornisce la fase di pagamento ospitata. Il tuo server conferma l’esito prima di evadere.
Crea l’ordine
Salva il totale del carrello, i dettagli del cliente e il tuo riferimento unico. Mantieni l’importo finale sotto il controllo del tuo server.
Crea il checkout ospitato
Invia la richiesta dal tuo server all’API v2 e indirizza il cliente all’URL di checkout restituito.
Conferma ed evadi
Gestisci il risultato del pagamento lato server, riconcilialo con il tuo ordine ed esegui l'evasione una sola volta.
Vedi il passo successivo.
Mantieni il carrello sul tuo sito web.
Il tuo server calcola l'importo da pagare e salva il riferimento all'ordine prima che venga creato il checkout.
Il cliente paga nella pagina di pagamento.
La tua integrazione invia il cliente all'URL di checkout restituito. L'apertura di un checkout non è prova di pagamento.
Conferma il pagamento prima dell'evasione.
Abbina un risultato di pagamento verificato al riferimento dell'ordine e all'importo. Gestisci notifiche ripetute senza evadere due volte.
La logica del tuo ordine.
Il nostro checkout ospitato.
Crea la pagina di pagamento dal tuo server. Invia il cliente all'URL di checkout restituito, quindi utilizza i risultati di pagamento verificati per aggiornare l'ordine.
L'esempio utilizza API v2 e unità di valuta principali: 15.99 significa £15.99 in GBP.
Conserva la chiave segreta sul tuo server. Firma il corpo JSON esatto che invii usando un timestamp aggiornato.
Conserva il payload e la chiave di idempotenza con il tuo ordine. Riutilizza entrambi solo per un tentativo esatto di quella richiesta.
Verifica l'esito del pagamento e confronta il riferimento, l'importo e la valuta prima di aggiornare il tuo ordine.
Questo è un esempio di creazione lato server, non un'integrazione completa per la produzione. Aggiungi la persistenza del tuo ordine, la gestione delle notifiche verificate, la gestione degli errori e la riconciliazione.
// 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.
Sostituisci il cliente di esempio e gli URL con i dati del tuo ordine e i relativi endpoint. Non inserire mai il tuo segreto API nel codice HTML della pagina o nel JavaScript lato client.
Più di un modo per vendere online.
Scegli il percorso di pagamento online che corrisponde a come i clienti ordinano dal tuo business.
Ordini dal sito web
Usa il tuo carrello esistente e invia i clienti a una pagina di pagamento ospitata per l'ultimo passo del checkout.
Prenotazioni e caparre
Costruisci un checkout basato su un importo prenotato concordato e collega il riferimento del pagamento con la prenotazione.
Portali clienti personalizzati
Aggiungi un passaggio di pagamento a un account cliente, a un ordine di servizio o a un flusso di lavoro business-to-business.
Mantieni le decisioni dove devono stare.
Un'integrazione affidabile inizia con una chiara divisione delle responsabilità. Il tuo sito web definisce l'ordine; il sistema di pagamento conferma se è stato pagato.
Valida il totale sul tuo server
Non fidarti di un prezzo fornito dal browser o di un riferimento d'ordine modificato dal cliente.
Tieni le credenziali fuori dal browser
La tua chiave segreta, la firma delle richieste e i controlli sull'esito del pagamento devono trovarsi sul tuo server.
Considera un reindirizzamento come una navigazione, non come una prova
Un cliente che arriva sulla tua pagina di ringraziamento non conferma, di per sé, un pagamento riuscito.
Un account. Più modi per essere pagato.
Scegli il percorso che corrisponde a come il tuo cliente acquista—non un percorso di pagamento universale.
Pagamenti online
Crea un checkout per il sito web.
Sei quiPagamenti Link
Richiedi un importo specifico.
Esplora Link Pagamenti →Pagamenti con fattura
Fattura con dettagli specifici.
Esplora Pagamenti Fatture →NeroForm
Lascia che il tuo cliente scelga un importo.
Esplora NeroForm →Contratti
Unisci accordo e pagamento.
Esplora Contratti →I pagamenti sono solo l'inizio.
Esplora gli strumenti NeroPay che si adattano al modo in cui la tua azienda serve i clienti—online, su appuntamento o al bancone.
NeroWeb
Menu e ordini online
Porta l'esperienza di ordinazione del cibo online e mantieni i pagamenti parte del percorso del cliente.
NeroBooking
Prenotazioni e servizio clienti
Tieni le informazioni di prenotazione vicine al resto della tua attività e scegli la richiesta di pagamento giusta per ogni servizio.
NeroPOS
Al banco e oltre
Collega il tuo servizio in presenza con l’esperienza più ampia NeroPay, dagli ordini alla cassa ai pagamenti con carta supportati.
Pagamenti online.
I dettagli utili.
Hai bisogno di aiuto per scegliere la configurazione giusta per il tuo business? Il nostro team può illustrarti le opzioni.
Parla con NeroPay →Devo creare un modulo di pagamento con carta personalizzato?
No. L'API crea una pagina di pagamento ospitata da NeroPay. Il tuo sito gestisce il carrello e reindirizza il cliente al checkout; i dati della carta vengono inseriti nella pagina ospitata.
Ho bisogno di uno sviluppatore per collegare un sito esistente?
Una integrazione API personalizzata di solito richiede uno sviluppatore. Se non ti serve un carrello personalizzato, Link Payments, Invoice Payments e NeroForm offrono altri modi per richiedere un pagamento.
Dove posso trovare il riferimento API?
Il riferimento API NeroPay v2 contiene i campi di richiesta, dettagli di autenticazione, esempi e indicazioni sulle notifiche di pagamento. Usa sempre l’ultimo riferimento disponibile per creare la tua integrazione.
Come deve il mio sito confermare che un ordine è stato pagato?
Usa un risultato di pagamento verificato lato server e confrontalo con il riferimento ordine e l’importo. Non evadere semplicemente perché la pagina di checkout si è aperta o il cliente è tornato a un URL di successo.
I pagamenti online e in presenza possono usare lo stesso account NeroPay?
Sì. Il tuo account NeroPay può supportare strumenti di pagamento online insieme alla tua configurazione di pagamento in presenza abilitata. I metodi disponibili e i requisiti dell’account dipendono dalla tua attività e regione.
Cosa significa l’importo nell’esempio API?
L’esempio usa unità maggiori di valuta: 15.99 significa £15.99 quando la valuta è GBP. Segui sempre il formato importo documentato nell’endpoint.
Dove posso verificare le tariffe e i dettagli di regolamento?
Consulta i prezzi correnti di NeroPay e i termini per il tuo account. Un pagamento cliente riuscito e la disponibilità dei fondi per il pagamento sono fasi separate; non promettere disponibilità istantanea dalla risposta del checkout.
Offri al tuo sito un percorso di pagamento che vale la pena completare.
Esplora il checkout ospitato, consulta il riferimento API e scegli la configurazione di pagamento online adatta alla tua attività.
Le funzionalità disponibili, i metodi di pagamento, l'idoneità, le commissioni e le condizioni di regolamento dipendono dal tuo account, dalla tua attività e dalla regione. Visualizza i prezzi attuali · Contattaci