Siirry sisältöön
MAKSUT · Verkkolaskut

Ostoskori.
Selkeämpi tapa maksaa.

Muunna verkkotilaus yksinkertaiseksi maksuprosessiksi. Yhdistä verkkosivustosi NeroPay, ohjaa asiakkaat isännöityyn kassaan ja tuo tulos takaisin liiketoimintaprosessiisi.

✓ Verkkosivuston kassa✓ API v2✓ Isännöity maksusivu

Räätälöity verkkosivustollesi tai sovellukseesi. Haluatko mieluummin valmiin jaettavan maksupyynnön? Tutustu sen sijaan Link Payments -toimintoon.

Isännöity kassa · API v2Esikatselu
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"
}
Tilaus ORDER-1001Asiakas jatkaa isännöityyn kassaan
£15.99
SINUN PALVELIMESI→ISÄNNÖITY KASSA→MAKSUN TULOS
Alkuperäinen vastaus luo kassasivun URL-osoitteen. Se ei vahvista maksua.
Asiakkaitasi vartenSelkeä summa ja isännöity kassasivu.
Kehittäjiäsi vartenYksi API-pyyntö maksusivun luomiseksi.
YrityksellesiSeuraa tulosta, ei pelkkää klikkausta.
MAKSUT ASTIAPALVELUN ULKOPUOLELLA

Myy verkossa. Pidä ostomatka yhteydessä.

Tarjoa asiakkaille suoraviivainen tapa maksaa ilman, että rakennat korttitietojen syöttötoimintoa omaan sivustoosi.

Kassasivu, joka sopii sivustoosi

Pidä oma ostoskori- ja tilauskokemuksesi. Luo maksusivu, kun asiakas on valmis, ja ohjaa hänet sitten NeroPay.

Kortin syöttö tapahtuu isännöidyllä kassasivulla

Integraatiosi lähettää tilaus- ja asiakastiedot — ei kortin raakadataa. Salainen API-avaimesi pysyy palvelimellasi.

Tuo takaisin tulos työnkulkuusi

Käytä yksilöllistä tilausviitettä ja maksuilmoituspäätepistettä yhdistääksesi maksutuloksen tilaukseen, joka sen loi.

OSTOSKORISTA MAKSUN SUORITUKSEEN

Yksinkertainen reitti tilauksesta kassalle.

Sivustosi hoitaa tilauslogiikan. NeroPay tarjoaa isännöidyn maksuvaiheen. Palvelimesi varmistaa lopputuloksen ennen täyttöä.

1

Luo tilaus

Tallenna ostoskorin summa, asiakastiedot ja oma yksilöllinen viitteesi. Pidä lopullinen summa palvelimesi hallussa.

2

Luo isännöity kassasivu

Lähetä pyyntö palvelimestasi API v2:lle ja ohjaa asiakas palautettuun kassasivun URL-osoitteeseen.

3

Vahvista ja täytä

Käsittele palvelinpuolen maksutulos, sovi se tilaukseesi ja suorita täyttäminen vain kerran.

TUTUSTU KULKUUN

Näe seuraava vaihe.

Tilaus tallennettu

Pidä ostoskori verkkosivustollasi.

Palvelimesi laskee maksettavan summan ja tallentaa tilausviitteen ennen kassasivun luomista.

Asiakkaan polku£15.99
KEHITTÄJÄLLESI

Tilauksesi logiikka.
Meidän isännöity kassamme.

Luo maksusivu palvelimeltasi. Lähetä asiakas palautettuun kassasivun URL-osoitteeseen ja käytä varmennettuja maksutuloksia päivittääksesi tilauksen.

01
Yksi palvelinpuolen integrointi

Esimerkissä käytetään API-versiota 2 ja suuria valuuttayksiköitä: 15.99 tarkoittaa £15.99 Iso-Britannian punnissa.

02
Todennettu ja allekirjoitettu

Pidä salainen avain palvelimellasi. Allekirjoita juuri se JSON-runko, jonka lähetät, käyttäen tuoretta aikaleimaa.

03
Yritä uudelleen luomatta uutta tilausta

Tallenna hyötykuorma ja idempotenssiavain tilauksesi kanssa. Käytä molempia uudelleen vain kyseisen pyynnön täsmälliseen uudelleenyrittämiseen.

04
Täytä kerran, vahvistuksen jälkeen

Varmista maksun tulos ja vertaa viitettä, summaa ja valuuttaa ennen tilauksesi päivittämistä.

Tämä on palvelinpuolen luontiesimerkki—ei täydellinen tuotantointegraatio. Lisää oma tilauksen tallennuksesi, vahvistettujen ilmoitusten käsittely, virheenkäsittely ja sovittaminen.

POST Palvelinpuolen kassojen esimerkki
// 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.

Korvaa esimerkin asiakas ja URL-osoitteet omilla tilausdatoillasi ja päätepisteilläsi. Älä koskaan laita API-salaisuuttasi sivun HTML:ään tai asiakaspuolen JavaScriptiin.

SUUNNITELTU AITOJEN MYYNTIEN MUKAAN

Verkkomyyntiin on enemmän kuin yksi tapa.

Valitse verkkopaymentavuste, joka vastaa tapaa, jolla asiakkaat tilaavat yritykseltäsi.

Verkkosivun tilaukset

Käytä olemassa olevaa ostoskoria ja ohjaa asiakkaat isännöidylle maksusivulle viimeistä kassavaihetta varten.

Ajanvaraukset ja ennakkomaksut

Rakenna kassa sovitun varausmäärän ympärille ja yhdistä maksun viite varaukseen.

Räätälöidyt asiakasportaalit

Lisää maksuvaihe asiakastilille, palvelutilaukselle tai yritykseltä yritykselle -työnkulkuun.

SINUN VERKKOSIVUSTOSI, SINUN TILAUSLOGIIKKASI

Pidä päätökset siellä, missä ne kuuluvat.

Luotettava integraatio alkaa selkeästä vastuunjaosta. Verkkosivustosi määrittelee tilauksen; maksujärjestelmä vahvistaa, onko se maksettu.

Vahvista summa palvelimellasi

Älä luota selaimen antamaan hintaan tai asiakkaan muokkaamaan tilausviitteeseen.

Pidä tunnistetiedot poissa selaimesta

Salainen avaimesi, pyyntöjen allekirjoitus ja maksutulosten tarkistukset kuuluvat palvelimellesi.

Kohdista uudelleenohjaus navigointina—ei todisteena

Asiakkaan saapuminen kiitos-sivullesi ei yksinään vahvista onnistunutta maksua.

OIKEAN TYÖKALUN VALINTA PYYNTÖÖN

Yksi tili. Lisää tapoja saada maksuja.

Valitse reitti, joka sopii asiakkaasi ostotapaan – ei yhden koon maksuratkaisua.

OSA YHDISTETTYÄ LIIKETOIMINTAA

Maksaminen on vasta alkua.

Tutustu NeroPay työkaluihin, jotka sopivat tapaan, jolla liiketoimintasi palvelee asiakkaita – verkossa, ajanvarauksella tai tiskillä.

NeroWeb

Verkkoruokalistat ja tilaukset
Vie ruoan tilauskokemus verkkoon ja pidä maksut osana asiakaspolkua.

Tutustu NeroWeb →

NeroBooking

Varaukset ja asiakaspalvelu
Pidä varauksen tiedot lähellä muuta liiketoimintaasi ja valitse oikea maksupyynnön muoto jokaiselle palvelulle.

Tutustu NeroBooking →

NeroPOS

Kassalta laajemmin
Yhdistä lähipalvelusi laajempaan NeroPay -kokemukseen, tilauksista kassalla tuettuihin korttimaksuihin.

Tutustu NeroPOS →
NeroPOS, NeroWeb ja NeroBooking -ohjelmistot ovat ilmaisia, kun käytät NeroPay -maksuja. Maksujen käsittely, laitteisto ja mahdolliset lisäpalvelut hinnoitellaan ja sopimusehdot määritellään erikseen. Näytä hinnoittelu →
KYSYMYKSESI VASTATTUNA

Verkkolaskutus.
Hyödyllisiä tietoja.

Tarvitsetko apua oikean ratkaisun valinnassa yrityksellesi? Tiimimme voi neuvoa sinua vaihtoehdoissa.

Ota yhteyttä NeroPay →

Virallinen API v2 -viite ↗

Tarvitseeko minun rakentaa oma korttimaksulomake?

Ei tarvitse. API luo NeroPay-isännöidyn maksusivun. Sivustosi hallitsee ostoskoria ja ohjaa asiakkaan kassalle; korttitiedot syötetään isännöidyssä sivussa.

Tarvitsenko kehittäjän yhdistämään olemassa olevan verkkosivun?

Räätälöity API-integrointi vaatii yleensä kehittäjän. Jos et tarvitse räätälöityä ostoskoria, Link Payments, Invoice Payments ja NeroForm tarjoavat muita tapoja pyytää maksua.

Mistä löydän API-viitteet?

NeroPay API v2 -viitteessä on pyyntökentät, todennustiedot, esimerkit ja ohjeet maksujen ilmoittamiseen. Käytä uusinta viitettä integraatiotasi rakentaessa.

Miten sivustoni pitäisi varmistaa, että tilaus on maksettu?

Käytä palvelinpuolen vahvistettua maksutulosta ja yhdistä se tilausviitteeseen ja summaan. Älä toteuta tilausta pelkästään sillä perusteella, että kassasivu avautui tai asiakas palasi onnistumissivulle.

Voivatko verkko- ja henkilökohtaiset maksut käyttää samaa NeroPay-tiliä?

Kyllä. NeroPay-tilisi voi tukea verkkolaskutustyökaluja myös käytössäsi olevan henkilökohtaisen maksujärjestelyn rinnalla. Käytettävissä olevat menetelmät ja tilivaatimukset riippuvat yrityksestäsi ja alueestasi.

Mitä esimerkin API-summat tarkoittavat?

Esimerkissä käytetään suurempia valuuttayksiköitä: 15.99 tarkoittaa £15.99, kun valuuttana on GBP. Noudata aina päätepisteen dokumentoitua summaformaattia.

Mistä voin tarkistaa maksut ja selvitystiedot?

Näet ajantasaiset NeroPay hinnoittelut ja tilisi ehdot. Onnistunut asiakasmaksu ja varojen vapautuminen maksua varten ovat eri vaiheita; älä lupaudu välitöntä saatavuutta kassavastauksen perusteella.

Tarjoa verkkosivustollesi maksukokemus, jonka asiakkaasi haluavat saattaa loppuun.

Tutustu isännöityyn kassaan, tarkista API-viite ja valitse yrityksellesi sopiva verkkolaskutustapa.