Passa al contenuto
NeroPay Menu | Risorse Integrazioni In evidenza
PAGAMENTI · Pagamenti Online

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à.

✓ Checkout su sito web✓ API v2✓ Pagina di pagamento ospitata

Realizzato per il tuo sito o applicazione. Preferisci una richiesta pronta da condividere? Esplora invece i Link Payments.

Checkout ospitato · API v2Anteprima
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"
}
Ordine ORDER-1001Il cliente procede al checkout ospitato
£15.99
IL TUO SERVER→CHECKOUT OSPITATO→RISULTATO DEL PAGAMENTO
La risposta iniziale crea un URL di checkout. Non conferma il pagamento.
Per i tuoi clientiUn importo chiaro e un checkout ospitato.
Per i tuoi sviluppatoriUna singola richiesta API per creare la pagina di pagamento.
Per la tua aziendaMonitora il risultato, non solo il clic.
PAGAMENTI OLTRE IL BANCO

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.

DAL CARRELLO AL PAGAMENTO

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.

1

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.

2

Crea il checkout ospitato

Invia la richiesta dal tuo server all’API v2 e indirizza il cliente all’URL di checkout restituito.

3

Conferma ed evadi

Gestisci il risultato del pagamento lato server, riconcilialo con il tuo ordine ed esegui l'evasione una sola volta.

ESPLORA IL FLUSSO

Vedi il passo successivo.

Ordine salvato

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.

Percorso del cliente£15.99
PER IL TUO SVILUPPATORE

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.

01
Un'integrazione lato server

L'esempio utilizza API v2 e unità di valuta principali: 15.99 significa £15.99 in GBP.

02
Autenticato e firmato

Conserva la chiave segreta sul tuo server. Firma il corpo JSON esatto che invii usando un timestamp aggiornato.

03
Riprova senza creare un nuovo ordine

Conserva il payload e la chiave di idempotenza con il tuo ordine. Riutilizza entrambi solo per un tentativo esatto di quella richiesta.

04
Evadi una sola volta, dopo la conferma

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.

POST Esempio di checkout lato server
// 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.

PROGETTATO INTORNO A VENDITE REALI

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.

IL TUO SITO WEB, LA TUA LOGICA D'ORDINE

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.

LO STRUMENTO GIUSTO PER LA RICHIESTA

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 qui
PARTE DI UN'AZIENDA CONNESSA

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.

Esplora NeroWeb →

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.

Esplora NeroBooking →

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.

Esplora NeroPOS →
Il software NeroPOS, NeroWeb e NeroBooking è gratuito quando usi i pagamenti NeroPay. L’elaborazione dei pagamenti, l’hardware e qualsiasi servizio opzionale hanno prezzi e termini propri applicabili. Visualizza tariffe →
LE TUE DOMANDE, RISPOSTE

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 →

Riferimento ufficiale API v2 ↗

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à.