Прескочи до съдържанието
ПЛАЩАНИЯ · Онлайн плащания

Вашето плащане.
По-ясен начин за плащане.

Превърнете онлайн поръчка в прост процес на плащане. Свържете уебсайта си с NeroPay, насочете клиентите към хостваното плащане и върнете резултата обратно в бизнес процеса си.

✓ Уеб плащане✓ API в 2✓ Хоствана страница за плащане

Създадено за вашия уебсайт или приложение. Предпочитате готова за споделяне заявка? Разгледайте вместо това Link Payments.

Хоствано плащане · API в 2Преглед
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"
}
Поръчка ORDER-1001Клиентът продължава към хостваното плащане
£15.99
ВАШИЯТ СЪРВЪР→ХОСТВАНО ПЛАЩАНЕ→РЕЗУЛТАТ ОТ ПЛАЩАНЕТО
Първоначалният отговор създава URL адрес за плащане. Той не потвърждава плащането.
За вашите клиентиЯсна сума и хоствано плащане.
За вашите разработчициЕдно API запитване за създаване на страницата за плащане.
За вашия бизнесПроследете резултата, не само кликването.
ПЛАЩАНИЯ ИЗВЪН КАСАТА

Продавайте онлайн. Поддържайте свързан процес.

Осигурете на клиентите прост начин за плащане без да изграждате форма за карта във вашия сайт.

Плащане, което пасва на вашия сайт

Запазете своята кошница и опит при поръчка. Създайте платформа за плащане, когато клиентът е готов, след което го пренасочете към NeroPay.

Въвеждането на карта остава в хостваното плащане

Вашата интеграция изпраща информация за поръчката и клиента — не сурови данни за карта. Вашият таен API ключ остава на вашия сървър.

Върнете резултата във вашия работен процес

Използвайте уникален референтен номер на поръчката и вашия крайна точка за уведомяване за плащането, за да свържете резултата с поръчката, която го е създала.

ОТ КОШНИЦАТА ДО ПЛАЩАНЕТО

Прост маршрут от поръчка до плащане.

Вашият сайт управлява логиката на поръчката. NeroPay предоставя хостваната стъпка за плащане. Вашият сървър потвърждава резултата преди изпълнение.

1

Създайте поръчката

Запишете общата стойност на кошницата, данните на клиента и вашия уникален референтен номер. Запазете крайната сума под контрол на вашия сървър.

2

Създайте хоствано плащане

Изпратете заявката от вашия сървър към API v2 и насочете клиента към върнатия URL за плащане.

3

Потвърдете и изпълнете

Обработвайте резултата от плащането на страна на сървъра, съпоставяйте го с поръчката си и изпълнявайте поръчката само веднъж.

ИЗСЛЕДВАЙТЕ ПРОЦЕСА

Вижте следващата стъпка.

Поръчката е запазена

Запазете кошницата на вашия уебсайт.

Вашият сървър изчислява сумата за плащане и запазва референцията на поръчката преди създаване на плащането.

Пътешествие на клиента£15.99
ЗА ВАШИЯ РАЗРАБОТЧИК

Вашата логика на поръчката.
Нашата хостната страница за плащане.

Създайте страницата за плащане от вашия сървър. Изпратете клиента до върнатия URL адрес за плащане, след което използвайте проверени резултати от плащания, за да актуализирате поръчката.

01
Една интеграция на сървърна страна

Примерът използва API v2 и основни валутни единици: 15.99 означава £15.99 в GBP.

02
Удостоверено и подписано

Дръжте тайния ключ на вашия сървър. Подписвайте точния JSON, който изпращате, използвайки актуално време.

03
Опитайте отново без създаване на нова поръчка

Запазете товара (payload) и ключа за идемпотентност с вашата поръчка. Използвайте ги отново само за точен повторен опит на същото искане.

04
Изпълнете веднъж, след потвърждение

Потвърдете резултата от плащането и съответствието на референцията, сумата и валутата, преди да актуализирате вашата поръчка.

Това е пример за създаване от страна на сървъра — не е пълна продукционна интеграция. Добавете собствена постоянност на поръчките, проверена обработка на уведомления, обработка на грешки и съгласуване.

POST Пример за плащане от страна на сървъра
// 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 на клиент на благодарствената страница не потвърждава успешно плащане.

ПОДХОДЯЩИЯТ ИНСТРУМЕНТ ЗА ИСКАНЕТО

Един акаунт. Повече начини за плащане.

Изберете пътя, който съответства на начина, по който клиентът ви пазарува — не универсално плащане за всички.

ЧАСТ ОТ СВЪРЗАН БИЗНЕС

Плащанията са само началото.

Разгледайте NeroPay инструментите, които съответстват на начина, по който вашият бизнес обслужва клиенти — онлайн, с назначение или на гишето.

NeroWeb

Онлайн менюта и поръчки
Пренесете изживяването на поръчка на храна онлайн и включете плащанията като част от клиентското преживяване.

Разгледайте NeroWeb →

NeroBooking

Резервации и обслужване на клиенти
Дръжте информацията за резервациите близо до останалата част от бизнеса си и изберете правилната заявка за плащане за всяка услуга.

Разгледайте NeroBooking →

NeroPOS

На касата и отвъд нея
Свържете вашата присъствена услуга с по-широкото NeroPay преживяване, от поръчките на касата до поддържаните плащания с карта.

Разгледайте NeroPOS →
NeroPOS, NeroWeb и NeroBooking софтуер е безплатен, когато използвате NeroPay плащания. Обработката на плащания, хардуерът и всички допълнителни услуги имат собствено приложимо ценообразуване и условия. Вижте цените →
ВАШИТЕ ВЪПРОСИ, ОТГОВОРЕНИ

Онлайн плащания.
Полезните подробности.

Имате нужда от помощ при избора на правилната настройка за вашия бизнес? Нашият екип може да ви разясни опциите.

Говорете с NeroPay →

Официална справка за API v2 ↗

Трябва ли да изградя собствен формуляр за картови плащания?

Не. API създава платена страница, хоствана от NeroPay. Вашият уебсайт контролира кошницата и пренасочва клиента към плащане; детайлите на картата се въвеждат на хостваната страница.

Трябва ли ми разработчик, за да свържа съществуващ уебсайт?

Персонализираната интеграция чрез API обикновено изисква разработчик. Ако не ви трябва персонализирана кошница, Link Payments, Invoice Payments и NeroForm предлагат други начини за искане на плащане.

Къде мога да намеря справката за API?

Справката за NeroPay API v2 съдържа полетата на заявката, данни за удостоверяване, примери и насоки за уведомяване при плащане. Използвайте най-актуалната справка при изграждане на интеграцията.

Как сайтът ми трябва да потвърди, че поръчката е платена?

Използвайте проверен резултат от страна на сървъра и го сравнете с референтния номер на поръчката и сумата. Не изпълнявайте поръчката само защото страницата за плащане се е отворила или клиентът се е върнал към URL за успех.

Могат ли онлайн и присъствени плащания да използват една и съща сметка NeroPay?

Да. Вашата сметка NeroPay може да поддържа онлайн платежни инструменти едновременно с активирания за присъствени плащания режим. Наличните методи и изисквания зависят от вашия бизнес и регион.

Какво означава сумата в примера за API?

Примерът използва основни единици валута: 15.99 означава £15.99 когато валутата е GBP. Винаги се придържайте към документирания в крайния пункт формат на сумата.

Къде мога да проверя таксите и подробностите за уреждане?

Прегледайте текущите цени на NeroPay и условията за вашата сметка. Успешното плащане от клиент и наличието на средства за изплащане са отделни етапи; не обещавайте незабавна наличност от отговора при плащане.

Дайте на сайта си платежно изживяване, което си струва да бъде завършено.

Разгледайте хостваното плащане, проверете справката за API и изберете подходящата онлайн платежна конфигурация за бизнеса си.