Prejsť na obsah
PLATBY · Online platby

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.

✓ Pokladničný proces na webstránke✓ API v2✓ Hostovaná platobná stránka

Navrhnuté pre vašu webovú stránku alebo aplikáciu. Uprednostňujete pripravený na zdieľanie požiadavok? Preskúmajte radšej Link Payments.

Hostovaná pokladňa · API v2Náhľad
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"
}
Objednávka ORDER-1001Zákazník pokračuje do hostovanej pokladne
£15.99
VÁŠ SERVER→HOSTOVANÁ POKLADŇA→VÝSLEDOK PLATBY
Počiatočná odpoveď vytvára URL adresu pokladne. Neznamená potvrdenie platby.
Pre vašich zákazníkovJasná suma a hostovaná pokladňa.
Pre vašich vývojárovJeden API požiadavok na vytvorenie platobnej stránky.
Pre vaše podnikanieSledujte výsledok, nielen kliknutie.
PLATBY MIMO PREDAJNÝ PULT

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.

OD KOŠÍKA K PLATBE

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.

1

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.

2

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.

3

Potvrdiť a vybaviť

Spracujte výsledok platby na strane servera, zosúhajte ho s vašou objednávkou a vybavte ju len raz.

PRESKÚMAŤ POSTUP

Pozrite si ďalší krok.

Objednávka uložená

Zachovajte košík na vašom webe.

Váš server vypočíta splatnú sumu a uloží referenciu objednávky pred vytvorením pokladne.

Cesta zákazníka£15.99
PRE VÁŠHO VÝVOJÁRA

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.

01
Jedna integrácia na strane servera

Príklad používa API v2 a hlavné menové jednotky: 15.99 znamená £15.99 v GBP.

02
Overené a podpísané

Tajný kľúč uchovávajte na svojom serveri. Podpíšte presné JSON telo, ktoré posielate, s čerstvým časovým údajom.

03
Opakovať bez vytvorenia novej objednávky

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.

04
Vybavte len raz, po potvrdení

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.

POST Príklad pokladne na strane servera
// 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.

NÁVRH PRE SKUTOČNÝ PREDAJ

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.

VAŠA WEBOVÁ STRÁNKA, VAŠA LOGIKA OBJEDNÁVKY

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.

SPRÁVNY NÁSTROJ NA POŽIADAVKU

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.

SÚČASŤ PREPOJENÉHO PODNIKANIA

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.

Preskúmajte NeroWeb →

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.

Preskúmajte NeroBooking →

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.

Preskúmajte NeroPOS →
NeroPOS, NeroWeb a NeroBooking softvér je zadarmo, keď používate NeroPay platby. Spracovanie platieb, hardvér a akékoľvek voliteľné služby majú svoje vlastné platné ceny a podmienky. Pozrieť ceny →
VAŠE OTÁZKY, ODPOVEDE

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 →

Oficiálna referencia API v2 ↗

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.