El teu procés de compra.
Una manera més clara de pagar.
Converteix una comanda en línia en un procés de pagament senzill. Connecta el teu lloc web amb NeroPay, envia els clients al procés de compra allotjat i porta el resultat de nou al flux de treball del teu negoci.
Dissenyat per al teu lloc web o aplicació. Prefereixes una sol·licitud preparada per compartir? Explora Pagaments amb Enllaç en canvi.
{
"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=..."
}
}Ven en línia. Mantén el procés connectat.
Dóna als clients una manera directa de pagar sense haver de crear un sistema d’entrada de targeta al teu propi lloc web.
Un procés de pagament que s’adapta al teu lloc
Mantén la teva pròpia cistella i experiència de comanda. Crea una pàgina de pagament quan el client estigui preparat i després redirigeix-lo a NeroPay.
L’entrada de la targeta es manté al procés de pagament allotjat
La teva integració envia la informació de la comanda i del client—no les dades de la targeta en brut. La teva clau API secreta es manté al teu servidor.
Porta el resultat al teu flux de treball
Utilitza una referència d’ordre única i el teu punt d’extrem de notificació de pagament per connectar el resultat del pagament amb la comanda que el va crear.
Una ruta simple de la comanda al procés de pagament.
El teu lloc conserva la lògica de la comanda. NeroPay proporciona l’etapa de pagament allotjada. El teu servidor confirma el resultat abans que facis l’enviament.
Crea la comanda
Desa el total de la cistella, les dades del client i la teva pròpia referència única. Mantén l’import final controlat pel teu servidor.
Crea el procés de pagament allotjat
Envia la sol·licitud des del teu servidor a l’API v2 i dirigeix el client a la URL del procés de pagament que es retorna.
Confirmar i complir
Gestiona el resultat del pagament des del costat del servidor, reconcília amb la teva comanda i processa el compliment només una vegada.
Mira el pròxim pas.
Mantingues el carretó al teu lloc web.
El teu servidor calcula l'import a pagar i desa la referència de la comanda abans que es creï la sortida de compra.
El client paga a la pàgina de pagament.
La teva integració envia el client a l'URL de sortida de compra retornat. Obrir una sortida de compra no és prova de pagament.
Confirma el pagament abans del compliment.
Fes coincidir un resultat de pagament verificat amb la referència i l'import de la comanda. Gestiona notificacions repetides sense complir dues vegades.
La lògica de la teva comanda.
La nostra sortida de compra allotjada.
Crea la pàgina de pagament des del teu servidor. Envia el client a l'URL de sortida de compra retornat i després utilitza els resultats de pagament verificats per actualitzar la comanda.
L'exemple usa l'API v2 i unitats principals de moneda: 15.99 significa £15.99 en GBP.
Mantingues la clau secreta al teu servidor. Signa el cos JSON exacte que envies utilitzant una marca de temps nova.
Persistix la càrrega útil i la clau d'idempotència amb la teva comanda. Reutilitza ambdues només per a un reintent exacte d'aquesta sol·licitud.
Verifica el resultat del pagament i comprova que la referència, l'import i la moneda coincideixen abans d'actualitzar la teva comanda.
Aquest és un exemple de creació del costat del servidor, no una integració completa per a producció. Afegeix la teva pròpia persistència de comandes, gestió de notificacions verificades, manejament d'errors i reconciliació.
// 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.
Substitueix l'exemple de client i les URL amb les dades i els punts finals de la teva comanda. Mai no col·loquis la teva clau secreta de l'API en l'HTML de la pàgina ni en JavaScript del costat del client.
Més d'una manera de vendre en línia.
Tria la via de pagament en línia que coincideixi amb la manera com els clients fan comandes al teu negoci.
Comandes des del lloc web
Utilitza la cistella existent i envia els clients a una pàgina de pagament allotjada per al pas final de la compra.
Reserves i dipòsits
Construeix un procés de compra basat en un import de reserva acordat i connecta la referència de pagament amb la reserva.
Portals de client personalitzats
Afegeix un pas de pagament a un compte de client, ordre de servei o flux de treball empresa a empresa.
Mantén les decisions allà on pertanyen.
Una integració fiable comença amb una divisió clara de responsabilitats. El teu lloc web defineix la comanda; el sistema de pagament confirma si s'ha pagat.
Valida el total al teu servidor
No confïïs en un preu facilitat pel navegador ni en una referència de comanda modificada pel client.
Mantén les credencials fora del navegador
La teva clau secreta, la signatura de les peticions i les verificacions del resultat del pagament han d'estar al teu servidor.
Tracta un redireccionament com a navegació—no com a prova
El fet que un client arribi a la teva pàgina d’agraïment no confirma, per si mateix, que el pagament hagi tingut èxit.
Un compte. Més maneres de cobrar.
Escull la via que coincideixi amb la forma en què compra el teu client, no un procés de pagament universal.
Pagaments en línia
Crea un procés de compra per a la web.
Ets aquíPagaments per enllaç
Sol·licita un import específic.
Explora Pagaments amb Enllaç →Pagaments amb factura
Factura amb detalls itemitzats.
Explora Pagaments de factures →NeroForm
Deixa que el teu client triï un import.
Explora NeroForm →Contractes
Uneix l'acord i el pagament.
Explora Contractes →Els pagaments són només el començament.
Explora les eines NeroPay que s'adapten a la manera com el vostre negoci serveix els clients—en línia, amb cita prèvia o al taulell.
NeroWeb
Menús i comandes en línia
Porta l'experiència de demanar menjar en línia i mantingueu els pagaments com a part del procés del client.
NeroBooking
Reserves i atenció al client
Mantingueu la informació de la reserva a prop de la resta del vostre negoci i trieu la sol·licitud de pagament adequada per a cada servei.
NeroPOS
A la caixa i més enllà
Connecta el teu servei presencial amb l'experiència més àmplia NeroPay, des de comandes a la caixa fins a pagaments amb targeta compatibles.
Pagaments en línia.
Els detalls útils.
Necessites ajuda per triar la configuració adequada per al teu negoci? El nostre equip pot explicar-te les opcions.
Parla amb NeroPay →Necessito crear un formulari de pagament amb targeta propi?
No. L'API crea una pàgina de pagament allotjada per NeroPay. El vostre lloc web controla la cistella i redirigeix el client al procés de compra; les dades de la targeta s'introdueixen a la pàgina allotjada.
Necessito un desenvolupador per connectar un lloc web existent?
Una integració personalitzada de l'API normalment necessita un desenvolupador. Si no necessiteu una cistella personalitzada, Link Payments, Invoice Payments i NeroForm ofereixen altres formes de sol·licitar el pagament.
On puc trobar la referència de l'API?
La referència de l'API NeroPay v2 conté els camps de sol·licitud, detalls d'autenticació, exemples i guia de notificació de pagament. Utilitzeu la referència més recent quan construïu la vostra integració.
Com hauria de confirmar el meu lloc que una comanda està pagada?
Utilitzeu un resultat de pagament verificat al servidor i compareu-lo amb la referència de comanda i l'import. No completeu la comanda només perquè s'ha obert la pàgina de compra o perquè el client ha tornat a una URL d'èxit.
Els pagaments en línia i presencials poden utilitzar la mateixa compte NeroPay?
Sí. El vostre compte NeroPay pot suportar eines de pagament en línia juntament amb la configuració habilitada per al pagament presencial. Els mètodes disponibles i els requisits del compte depenen de la vostra empresa i regió.
Què significa l'import en l'exemple de l'API?
L'exemple utilitza unitats principals de moneda: 15.99 significa £15.99 quan la moneda és GBP. Seguiu sempre el format d'import documentat de l'endpoint.
On puc consultar les tarifes i els detalls de liquidació?
Consulteu els preus actuals de NeroPay i els termes per al vostre compte. Un pagament exitós del client i que els fons estiguin disponibles per al pagament són etapes separades; no prometeu disponibilitat instantània a partir de la resposta del procés de compra.
Doneu al vostre lloc web una experiència de pagament que val la pena completar.
Exploreu el procés de compra allotjat, consulteu la referència de l'API i trieu la configuració de pagament en línia adequada per al vostre negoci.
Les funcionalitats disponibles, els mètodes de pagament, l'elegibilitat, les tarifes i les condicions de liquidació depenen del vostre compte, negoci i regió. Veure els preus actuals · Contacteu amb nosaltres




