Váš pokladničný proces.
Jasnejší spôsob platby.
Premeňte online objednávku na jednoduchú platobnú cestu. Prepojte svoju webovú stránku s NeroPay, pošlite zákazníkov na hostené pokladničné rozhranie a prineste výsledok späť do svojho obchodného workflow.
Navrhnuté pre vašu webovú stránku alebo aplikáciu. Uprednostňujete pripravený na zdieľanie požiadavok? Preskúmajte radšej 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=..."
}
}Predávajte online. Udržujte prepojený priebeh.
Ponúknite zákazníkom jednoduchý spôsob platby bez nutnosti vytvárať vlastný formulár pre zadanie karty na vašej stránke.
Pokladňa prispôsobená vašej stránke
Zachovajte vlastný košík a objednávkový proces. Vytvorte platobnú stránku, keď je zákazník pripravený, a potom ho presmerujte na NeroPay.
Zadávanie karty zostáva v hostovanej pokladni
Vaša integrácia odosiela informácie o objednávke a zákazníkovi – nie surové údaje o karte. Váš tajný API kľúč ostáva na vašom serveri.
Prineste výsledok späť do svojho workflow
Použite jedinečný odkaz na objednávku a váš koncový bod oznámenia o platbe na prepojenie výsledku platby s objednávkou, ktorá ju vytvorila.
Jednoduchá cesta od objednávky k pokladni.
Vaša stránka spravuje logiku objednávky. NeroPay poskytuje hostovanú platobnú fázu. Váš server potvrdzuje výsledok pred vybavením objednávky.
Vytvorte objednávku
Uložte celkovú sumu košíka, údaje o zákazníkovi a váš vlastný jedinečný odkaz. Konečnú sumu nech má pod kontrolou váš server.
Vytvorte hostovanú pokladňu
Odošlite požiadavku z vášho servera na API v2 a nasmerujte zákazníka na vrátenú URL adresu pokladne.
Potvrdiť a vybaviť
Spracujte výsledok platby na strane servera, zosúhajte ho s vašou objednávkou a vybavte ju len raz.
Pozrite si ďalší krok.
Zachovajte košík na vašom webe.
Váš server vypočíta splatnú sumu a uloží referenciu objednávky pred vytvorením pokladne.
Zákazník platí na platobnej stránke.
Vaša integrácia presmeruje zákazníka na vrátenú URL pokladne. Otvorenie pokladne nie je dokladom o platbe.
Potvrďte platbu pred vybavením.
Porovnajte overený výsledok platby s referenciou objednávky a sumou. Opakované notifikácie spracujte bez dvojnásobného vybavenia.
Logika vašej objednávky.
Naša hostovaná pokladňa.
Vytvorte platobnú stránku zo svojho servera. Pošlite zákazníka na vrátenú URL pokladne a potom použite overené výsledky platby na aktualizáciu objednávky.
Príklad používa API v2 a hlavné menové jednotky: 15.99 znamená £15.99 v GBP.
Tajný kľúč uchovávajte na svojom serveri. Podpíšte presné JSON telo, ktoré posielate, s čerstvým časovým údajom.
Uložte si platobný obsah a idempotentný kľúč spolu s objednávkou. Oba použite znova iba pri presnom opakovaní toho istého požiadavku.
Overte výsledok platby a porovnajte referenciu, sumu a menu pred aktualizáciou vašej objednávky.
Toto je príklad vytvorenia na strane servera – nie kompletná produkčná integrácia. Pridajte vlastnú persistenciu objednávok, overené spracovanie notifikácií, spracovanie chýb a zosúladenie.
// 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.
Nahraďte príkladového zákazníka a URL adresy údajmi vašej objednávky a koncovými bodmi. Nikdy neumiestňujte svoje API tajomstvo do HTML stránky ani do JavaScriptu na strane klienta.
Viacero spôsobov, ako predávať online.
Vyberte cestu online platby, ktorá zodpovedá spôsobu, akým zákazníci objednávajú vo vašom podniku.
Objednávky z webovej stránky
Použite svoj existujúci košík a nasmerujte zákazníkov na hosťovanú platobnú stránku pre záverečný krok pokladne.
Rezervácie a zálohy
Vybudujte pokladňu okolo dohodnutej sumy rezervácie a prepojte platobnú referenciu s rezerváciou.
Zákaznícke portály na mieru
Pridajte platobný krok k zákazníckemu účtu, objednávke služby alebo pracovnému postupu business-to-business.
Nechajte rozhodnutia tam, kde patria.
Spoľahlivá integrácia začína jasným rozdelením zodpovednosti. Vaša webová stránka definuje objednávku; platobný systém potvrdzuje, či bola zaplatená.
Overte celkovú sumu na vašom serveri
Nedôverujte cene poskytnutej prehliadačom ani zákazníkom upravenej referencii objednávky.
Neposkytujte prihlasovacie údaje do prehliadača
Vaše tajné kľúče, podpisovanie požiadaviek a kontroly výsledku platby patria na váš server.
Považujte presmerovanie za navigáciu – nie za dôkaz
Zákazník pristupujúci na vašu ďakovnú stránku sám o sebe nepotvrdzuje úspešnú platbu.
Jeden účet. Viac spôsobov, ako dostať zaplatené.
Vyberte cestu, ktorá zodpovedá spôsobu, akým zákazník nakupuje — nie univerzálnu platobnú cestu pre všetkých.
Online platby
Vytvorte webovú pokladňu.
Nachádzate sa tuPlatby cez odkaz
Požiadajte o konkrétnu sumu.
Preskúmajte Prepojené platby →Platby faktúr
Faktúra s položkovými detailmi.
Preskúmajte Platby faktúr →NeroForm
Nechajte zákazníka vybrať sumu.
Preskúmajte NeroForm →Zmluvy
Spojte dohodu a platbu dohromady.
Preskúmajte zmluvy →Platby sú len začiatok.
Preskúmajte NeroPay nástroje, ktoré zodpovedajú spôsobu, akým vaše podnikanie poskytuje služby zákazníkom – online, na objednávku alebo priamo na mieste.
NeroWeb
Online menu a objednávky
Preneste svoju skúsenosť s objednávaním jedla online a zachovajte platby ako súčasť zákazníckej cesty.
NeroBooking
Rezervácie a zákaznícky servis
Majte informácie o rezervácii blízko ostatného chodu vášho podnikania a vyberte správnu platobnú požiadavku pre každú službu.
NeroPOS
Na pokladni aj ďalej
Prepojte svoju službu pri osobnom kontakte so širším NeroPay zážitkom, od objednávok na pokladni až po podporované platby kartou.
Online platby.
Užitočné podrobnosti.
Potrebujete pomoc s výberom správneho nastavenia pre váš podnik? Náš tím vám predstaví možnosti.
Porozprávajte sa s NeroPay →Potrebujem si vytvoriť vlastný formulár pre platbu kartou?
Nie. API vytvára NeroPay hostovanú platobnú stránku. Vaša webová stránka ovláda košík a presmeruje zákazníka na pokladňu; detaily karty sa zadávajú na hostovanej stránke.
Potrebujem vývojára na prepojenie existujúcej webovej stránky?
Vlastná API integrácia zvyčajne potrebuje vývojára. Ak nepotrebujete vlastný košík, Link Payments, Invoice Payments a NeroForm poskytujú iné spôsoby požiadania o platbu.
Kde nájdem referenciu API?
Referencia NeroPay API v2 obsahuje polia požiadaviek, detaily autentifikácie, príklady a návod pre notifikácie o platbe. Pri tvorbe integrácie používajte najnovšiu referenciu.
Ako by mala moja stránka potvrdiť, že objednávka bola zaplatená?
Použite overený výsledok platby na strane servera a zhodnoťte ho s referenciou objednávky a sumou. Nevybavujte objednávku len preto, že sa otvorila pokladňa alebo že sa zákazník vrátil na úspešnú URL adresu.
Môžu online a osobné platby používať rovnaký NeroPay účet?
Áno. Váš NeroPay účet môže podporovať online platobné nástroje vedľa povoleného nastavenia osobnej platby. Dostupné metódy a požiadavky na účet závisia od vášho podnikania a regiónu.
Čo znamená suma v príklade API?
Príklad používa hlavné jednotky meny: 15.99 znamená £15.99, keď je menou GBP. Vždy sa riaďte dokumentovaným formátom sumy na koncovom bode.
Kde môžem skontrolovať poplatky a detaily vyrovnania?
Pozrite si aktuálne ceny NeroPay a podmienky pre váš účet. Úspešná platba zákazníka a sprístupnenie prostriedkov na výplatu sú odlišné fázy; nesľubujte okamžitú dostupnosť na základe odpovede pokladne.
Dajte svojej webovej stránke platobnú cestu, ktorú stojí za to dokončiť.
Preskúmajte hostovanú pokladňu, skontrolujte referenciu API a vyberte vhodné nastavenie online platby pre vaše podnikanie.
Dostupné funkcie, spôsoby platby, oprávnenosť, poplatky a podmienky vyrovnania závisia od vášho účtu, podnikania a regiónu. Zobraziť aktuálne ceny · Kontaktujte nás