Вашето плащане.
По-ясен начин за плащане.
Превърнете онлайн поръчка в прост процес на плащане. Свържете уебсайта си с NeroPay, насочете клиентите към хостваното плащане и върнете резултата обратно в бизнес процеса си.
Създадено за вашия уебсайт или приложение. Предпочитате готова за споделяне заявка? Разгледайте вместо това 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=..."
}
}Продавайте онлайн. Поддържайте свързан процес.
Осигурете на клиентите прост начин за плащане без да изграждате форма за карта във вашия сайт.
Плащане, което пасва на вашия сайт
Запазете своята кошница и опит при поръчка. Създайте платформа за плащане, когато клиентът е готов, след което го пренасочете към NeroPay.
Въвеждането на карта остава в хостваното плащане
Вашата интеграция изпраща информация за поръчката и клиента — не сурови данни за карта. Вашият таен API ключ остава на вашия сървър.
Върнете резултата във вашия работен процес
Използвайте уникален референтен номер на поръчката и вашия крайна точка за уведомяване за плащането, за да свържете резултата с поръчката, която го е създала.
Прост маршрут от поръчка до плащане.
Вашият сайт управлява логиката на поръчката. NeroPay предоставя хостваната стъпка за плащане. Вашият сървър потвърждава резултата преди изпълнение.
Създайте поръчката
Запишете общата стойност на кошницата, данните на клиента и вашия уникален референтен номер. Запазете крайната сума под контрол на вашия сървър.
Създайте хоствано плащане
Изпратете заявката от вашия сървър към API v2 и насочете клиента към върнатия URL за плащане.
Потвърдете и изпълнете
Обработвайте резултата от плащането на страна на сървъра, съпоставяйте го с поръчката си и изпълнявайте поръчката само веднъж.
Вижте следващата стъпка.
Запазете кошницата на вашия уебсайт.
Вашият сървър изчислява сумата за плащане и запазва референцията на поръчката преди създаване на плащането.
Клиентът плаща на страницата за плащане.
Вашата интеграция насочва клиента към върнатия URL адрес за плащане. Отварянето на плащане не е доказателство за плащане.
Потвърдете плащането преди изпълнение.
Съпоставете проверен резултат от плащане с референцията на поръчката и сумата. Обработвайте повторни известия без да изпълнявате два пъти.
Вашата логика на поръчката.
Нашата хостната страница за плащане.
Създайте страницата за плащане от вашия сървър. Изпратете клиента до върнатия URL адрес за плащане, след което използвайте проверени резултати от плащания, за да актуализирате поръчката.
Примерът използва API v2 и основни валутни единици: 15.99 означава £15.99 в GBP.
Дръжте тайния ключ на вашия сървър. Подписвайте точния JSON, който изпращате, използвайки актуално време.
Запазете товара (payload) и ключа за идемпотентност с вашата поръчка. Използвайте ги отново само за точен повторен опит на същото искане.
Потвърдете резултата от плащането и съответствието на референцията, сумата и валутата, преди да актуализирате вашата поръчка.
Това е пример за създаване от страна на сървъра — не е пълна продукционна интеграция. Добавете собствена постоянност на поръчките, проверена обработка на уведомления, обработка на грешки и съгласуване.
// 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.
Заменете примерния клиент и URL адресите с данните и крайните точки на вашата поръчка. Никога не поставяйте своя API ключ в HTML на страницата или в клиентски JavaScript.
Повече от един начин за онлайн продажба.
Изберете онлайн начина на плащане, който съответства на начина, по който клиентите поръчват от вашия бизнес.
Поръчки през уебсайт
Използвайте съществуващата си кошница и изпратете клиентите към хоствана страница за плащане за крайния етап на поръчката.
Резервации и депозити
Създайте плащане, базирано на уговорена резервирана сума, и свържете референцията за плащане с резервацията.
Персонализирани клиентски портали
Добавете стъпка за плащане към клиентски акаунт, поръчка за услуга или бизнес към бизнес процес.
Оставете решенията там, където им е мястото.
Надеждна интеграция започва с ясна разделителна способност на отговорностите. Вашият уебсайт дефинира поръчката; платежната система потвърждава дали е платена.
Проверявайте общата сума на вашия сървър
Не се доверявайте на цена от браузъра или на референция на поръчка, редактирана от клиента.
Пазете поверителните данни извън браузъра
Вашият таен ключ, подписването на заявките и проверките на резултата от плащането принадлежат на вашия сървър.
Третирайте пренасочване като навигация — не като доказателство
Само landing на клиент на благодарствената страница не потвърждава успешно плащане.
Един акаунт. Повече начини за плащане.
Изберете пътя, който съответства на начина, по който клиентът ви пазарува — не универсално плащане за всички.
Онлайн плащания
Създайте уебсайт с каса.
Вие сте тукПлащания чрез линк
Изискайте конкретна сума.
Разгледайте Свързване на плащания →Плащания по фактури
Фактурирайте с подробни артикули.
Разгледайте Плащания по фактури →NeroForm
Позволете на клиента да избере сума.
Разгледайте NeroForm →Договори
Съберете съгласието и плащането заедно.
Разгледайте договорите →Плащанията са само началото.
Разгледайте NeroPay инструментите, които съответстват на начина, по който вашият бизнес обслужва клиенти — онлайн, с назначение или на гишето.
NeroWeb
Онлайн менюта и поръчки
Пренесете изживяването на поръчка на храна онлайн и включете плащанията като част от клиентското преживяване.
NeroBooking
Резервации и обслужване на клиенти
Дръжте информацията за резервациите близо до останалата част от бизнеса си и изберете правилната заявка за плащане за всяка услуга.
NeroPOS
На касата и отвъд нея
Свържете вашата присъствена услуга с по-широкото NeroPay преживяване, от поръчките на касата до поддържаните плащания с карта.
Онлайн плащания.
Полезните подробности.
Имате нужда от помощ при избора на правилната настройка за вашия бизнес? Нашият екип може да ви разясни опциите.
Говорете с NeroPay →Трябва ли да изградя собствен формуляр за картови плащания?
Не. API създава платена страница, хоствана от NeroPay. Вашият уебсайт контролира кошницата и пренасочва клиента към плащане; детайлите на картата се въвеждат на хостваната страница.
Трябва ли ми разработчик, за да свържа съществуващ уебсайт?
Персонализираната интеграция чрез API обикновено изисква разработчик. Ако не ви трябва персонализирана кошница, Link Payments, Invoice Payments и NeroForm предлагат други начини за искане на плащане.
Къде мога да намеря справката за API?
Справката за NeroPay API v2 съдържа полетата на заявката, данни за удостоверяване, примери и насоки за уведомяване при плащане. Използвайте най-актуалната справка при изграждане на интеграцията.
Как сайтът ми трябва да потвърди, че поръчката е платена?
Използвайте проверен резултат от страна на сървъра и го сравнете с референтния номер на поръчката и сумата. Не изпълнявайте поръчката само защото страницата за плащане се е отворила или клиентът се е върнал към URL за успех.
Могат ли онлайн и присъствени плащания да използват една и съща сметка NeroPay?
Да. Вашата сметка NeroPay може да поддържа онлайн платежни инструменти едновременно с активирания за присъствени плащания режим. Наличните методи и изисквания зависят от вашия бизнес и регион.
Какво означава сумата в примера за API?
Примерът използва основни единици валута: 15.99 означава £15.99 когато валутата е GBP. Винаги се придържайте към документирания в крайния пункт формат на сумата.
Къде мога да проверя таксите и подробностите за уреждане?
Прегледайте текущите цени на NeroPay и условията за вашата сметка. Успешното плащане от клиент и наличието на средства за изплащане са отделни етапи; не обещавайте незабавна наличност от отговора при плащане.
Дайте на сайта си платежно изживяване, което си струва да бъде завършено.
Разгледайте хостваното плащане, проверете справката за API и изберете подходящата онлайн платежна конфигурация за бизнеса си.
Наличните функции, методи за плащане, изисквания, такси и условия за уреждане зависят от вашия акаунт, бизнес и регион. Вижте текущите цени · Свържете се с нас