Preskoči na sadržaj
UPLATE · Online uplate

Vaša naplata.
Jasniji način plaćanja.

Pretvorite online narudžbu u jednostavan proces plaćanja. Povežite svoju web stranicu s NeroPay, usmjerite kupce na hostanu naplatu i vratite rezultat natrag u poslovni tijek.

✓ Nagrada na web stranici✓ API v2✓ Hostana stranica za plaćanje

Izrađeno za vašu web stranicu ili aplikaciju. Radije biste gotov zahtjev za dijeljenje? Umjesto toga istražite Link Payments.

Hostana naplata · API v2Pregled
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"
}
Narudžba ORDER-1001Kupac nastavlja na hostanu naplatu
£15.99
VAŠ POSLUŽITELJ→HOSTANA NAPLATA→REZULTAT PLAĆANJA
Početni odgovor kreira URL naplate. Ne potvrđuje uplatu.
Za vaše kupceJasan iznos i hostirana naplata.
Za vaše programereJedan API zahtjev za kreiranje stranice za plaćanje.
Za vaše poslovanjePratite ishod, ne samo klik.
PLAĆANJA IZVAN BLAGAJNE

Prodajte online. Održavajte povezan tok.

Pružite kupcima jednostavan način plaćanja bez izgradnje sustava unosa kartice na vlastitoj web stranici.

Naplatna stranica koja se uklapa u vašu stranicu

Zadržite vlastitu košaricu i narudžbu. Kreirajte stranicu plaćanja kad je kupac spreman, zatim ih preusmjerite na NeroPay.

Unos kartice ostaje u hostiranoj naplati

Vaša integracija šalje podatke o narudžbi i kupcu—ne sirove kartične podatke. Vaš tajni API ključ ostaje na vašem serveru.

Vratite rezultat u svoj tijek rada

Koristite jedinstvenu referencu narudžbe i svoju točku za obavijesti o plaćanju kako biste povezali ishod plaćanja s narudžbom koja ga je kreirala.

OD KOŠARICE DO PLAĆANJA

Jednostavan put od narudžbe do naplate.

Vaša stranica zadržava logiku narudžbe. NeroPay osigurava korak hostirane naplate. Vaš server potvrđuje ishod prije ispunjenja.

1

Kreirajte narudžbu

Spremite ukupnu vrijednost košarice, podatke kupca i vlastitu jedinstvenu referencu. Završni iznos kontrolira vaš server.

2

Kreirajte hostiranu naplatu

Pošaljite zahtjev s vašeg servera na API verziju 2 i usmjerite kupca na vraćeni URL naplate.

3

Potvrdi i izvrši

Obradite rezultat plaćanja na strani poslužitelja, uskladite ga s vašom narudžbom i izvršite ispunjavanje samo jednom.

ISTRAŽITE PROTOK

Pogledajte sljedeći korak.

Narudžba spremljena

Zadržite košaricu na vašoj web stranici.

Vaš poslužitelj izračunava iznos za plaćanje i sprema referencu narudžbe prije nego što se kreira naplata.

Kupčevo putovanje£15.99
ZA VAŠEG RAZVOJNU OSOBU

Logika vaše narudžbe.
Naše hostano plaćanje.

Kreirajte stranicu za plaćanje s vašeg poslužitelja. Pošaljite kupca na vraćeni URL naplate, zatim upotrijebite provjerene rezultate plaćanja za ažuriranje narudžbe.

01
Jedna integracija na strani poslužitelja

Primjer koristi API v2 i glavne valute: 15.99 znači £15.99 u GBP.

02
Autentificirano i potpisano

Tajni ključ držite na svom poslužitelju. Potpišite točno JSON tijelo koje šaljete koristeći svježe vremensko obilježje.

03
Ponovite bez kreiranja nove narudžbe

Sačuvajte sadržaj zahtjeva i ključ idempotencije s vašom narudžbom. Ponovno koristite oba samo za točan pokušaj ponovnog slanja tog zahtjeva.

04
Ispunite jednom, nakon potvrde

Provjerite rezultat uplate i uskladite referencu, iznos i valutu prije nego što ažurirate svoju narudžbu.

Ovo je primjer kreiranja na strani poslužitelja - nije potpuna integracija za produkciju. Dodajte vlastito pohranjivanje narudžbi, provjeru obavijesti, rukovanje pogreškama i usklađivanje.

POST Primjer naplate na strani poslužitelja
// 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.

Zamijenite primjer kupca i URL-ove svojim podacima o narudžbi i krajnjim točkama. Nikada nemojte stavljati svoj API tajni ključ u HTML stranice ili JavaScript na strani klijenta.

DIZAJNIRANO IMAJUĆI U VIDU STVARNU PRODAJU

Više načina za prodaju putem interneta.

Odaberite način internetske uplate koji odgovara načinu na koji kupci naručuju kod vašeg poslovanja.

Narudžbe sa web stranice

Koristite postojeću košaricu i pošaljite kupce na hostiranu stranicu za plaćanje kao posljednji korak naplate.

Rezervacije i predujmovi

Izgradite postupak naplate oko dogovorenog iznosa rezervacije i povežite referencu uplate s rezervacijom.

Prilagođeni portali za kupce

Dodajte korak plaćanja u korisnički račun, narudžbu usluge ili poslovni proces između tvrtki.

VAŠA WEB STRANICA, VAŠA LOGIKA NARUDŽBE

Odluke držite tamo gdje pripadaju.

Pouzdana integracija počinje jasnom podjelom odgovornosti. Vaša web stranica definira narudžbu; sustav plaćanja potvrđuje je li plaćena.

Potvrdite ukupni iznos na svom poslužitelju

Ne vjerujte cijeni koju dostavi preglednik ili referenci narudžbe uređivanoj od strane kupca.

Držite vjerodajnice izvan preglednika

Vaš tajni ključ, potpisivanje zahtjeva i provjere rezultata plaćanja moraju biti na vašem poslužitelju.

Preusmjeravanje tretirajte kao navigaciju - ne kao dokaz

Kupac koji dođe na vašu stranicu za zahvalnost sam po sebi ne potvrđuje uspješnu uplatu.

PRAVI ALAT ZA ZAHTJEV

Jedan račun. Više načina za primanje uplata.

Odaberite put koji odgovara načinu na koji vaš kupac kupuje — ne univerzalni način plaćanja.

DIO POVEZANOG POSLOVANJA

Plaćanja su tek početak.

Istražite NeroPay alate koji odgovaraju načinu na koji vaše poslovanje služi kupce—na mreži, prema dogovoru ili na kasi.

NeroWeb

Online meniji i narudžbe
Prebacite iskustvo naručivanja hrane na mrežu i zadržite plaćanja kao dio puta kupca.

Istražite NeroWeb →

NeroBooking

Rezervacije i korisnička služba
Držite informacije o rezervacijama blizu ostatka svog poslovanja i odaberite pravi zahtjev za plaćanje za svaku uslugu.

Istražite NeroBooking →

NeroPOS

Na blagajni i dalje
Povežite svoju uslugu uživo s širom NeroPay iskustvom, od narudžbi na kasi do podržanih kartičnih uplata.

Istražite NeroPOS →
NeroPOS, NeroWeb i NeroBooking softver je besplatan kada koristite NeroPay plaćanja. Obrada plaćanja, hardver i sve dodatne usluge imaju vlastite primjenjive cijene i uvjete. Pogledajte cijene →
VAŠA PITANJA, ODGOVORENA

Online uplate.
Korisni detalji.

Trebate li pomoć pri odabiru pravog rješenja za svoje poslovanje? Naš tim vam može objasniti dostupne opcije.

Razgovarajte s NeroPay →

Službena API v2 referenca ↗

Trebam li napraviti vlastiti obrazac za plaćanje karticom?

Ne. API stvara NeroPay-hostiranu stranicu za plaćanje. Vaša web stranica kontrolira košaricu i preusmjerava kupca na naplatu; podaci o kartici unose se na hostiranoj stranici.

Trebam li programera za povezivanje postojeće web stranice?

Prilagođena API integracija obično zahtijeva programera. Ako vam nije potrebna prilagođena košarica, Link Payments, Invoice Payments i NeroForm nude druge načine za zahtjev plaćanja.

Gdje mogu pronaći API referencu?

NeroPay API v2 referenca sadrži polja zahtjeva, detalje autentifikacije, primjere i upute za notifikacije plaćanja. Koristite najnoviju referencu prilikom izrade integracije.

Kako moja stranica treba potvrditi da je narudžba plaćena?

Koristite verificirani rezultat plaćanja na serverskoj strani i uskladite ga s referencom narudžbe i iznosom. Nemojte izvršiti isporuku samo zato što se otvorila stranica za naplatu ili se kupac vratio na URL uspjeha.

Mogu li online i osobna plaćanja koristiti isti NeroPay račun?

Da. Vaš NeroPay račun može podržavati online alate za plaćanje uz omogućenu konfiguraciju osobnih uplata. Dostupne metode i zahtjevi računa ovise o vašem poslovanju i regiji.

Što iznos u API primjeru znači?

Primjer koristi glavne valute: 15.99 znači £15.99 kada je valuta GBP. Uvijek slijedite dokumentirani format iznosa endpointa.

Gdje mogu provjeriti naknade i detalje procesa namire?

Pogledajte trenutačne cijene NeroPay i uvjete za vaš račun. Uspješno plaćanje kupca i dostupnost sredstava za isplatu su odvojene faze; nemojte obećavati trenutnu dostupnost na temelju odgovora checkouta.

Dajte svojoj web-stranici put platnog iskustva vrijedan dovršetka.

Istražite hostiranu naplatu, provjerite API referencu i odaberite pravi online način plaćanja za svoje poslovanje.