您的结账。
更清晰的支付方式。
将在线订单转变为简单的支付流程。将您的网站连接到 NeroPay,将客户引导到托管结账页面,并将结果带回您的业务流程中。
为您的网站或应用程序打造。更喜欢即用型请求?请探索链接支付。
{
"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,并将客户引导至返回的结账网址。
确认并完成
处理服务器端的支付结果,将其与您的订单对账,并且仅处理一次履行。
查看下一步。
在您的网站上保留购物篮。
您的服务器在创建结账之前计算应付金额并保存订单参考。
客户在支付页面完成付款。
您的集成将客户发送至返回的结账网址。结账页面的打开不表示支付已完成。
在完成履行前确认支付。
将已验证的支付结果与订单参考和金额匹配。处理重复通知时避免重复履行。
您的订单逻辑。
我们的托管结账。
从您的服务器创建支付页面。将客户发送到返回的结账网址,然后使用验证过的支付结果更新订单。
示例使用 API v2 和主要货币单位:15.99 表示英镑中的 £15.99。
将密钥保存在服务器端。使用最新的时间戳对您发送的准确 JSON 正文进行签名。
将负载和幂等性密钥与订单一起持久保存。仅对完全相同的请求重用它们。
在更新订单之前,请核实支付结果并核对参考编号、金额和货币。
这是一个服务器端创建示例——不是完整的生产集成。请添加您自己的订单持久化、已验证的通知处理、错误处理和对账。
// 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中。
线上销售不止一种方式。
选择符合客户从您企业下单方式的在线支付路径。
网站订单
使用您现有的购物篮,将客户导向托管支付页完成最终结账步骤。
预约与定金
围绕约定的预订金额构建结账,并将支付参考与预订关联。
定制客户门户
为客户账户、服务订单或企业对企业工作流添加支付步骤。
让决策保留在应有的位置。
可靠的集成从明确的责任划分开始。您的网站定义订单;支付系统确认是否已支付。
在服务器端验证总价
不要相信浏览器提供的价格或客户编辑的订单参考。
将凭证保存在服务器端,避免放入浏览器
您的密钥、请求签名和支付结果验证应放在服务器端。
将重定向视为导航,而非支付证明
仅客户访问您的谢谢页面,不能单独确认支付成功。
一个账户。更多收款方式。
选择符合您的客户购买习惯的方式—而非千篇一律的支付流程。
在线支付
构建网站结账流程。
您所在的位置链接支付
请求指定金额。
探索链接支付 →发票支付
提供明细账单。
探索发票付款 →NeroForm
让您的客户选择付款金额。
探索 NeroForm →合同
将协议与付款结合起来。
探索合同 →支付只是开始。
探索适合您业务服务客户方式的 NeroPay 工具——在线、预约或柜台服务。
NeroWeb
在线菜单和订单
将您的点餐体验搬到线上,并让支付成为客户旅程的一部分。
NeroBooking
预订和客户服务
将预订信息与您业务的其他部分紧密联系起来,为每项服务选择合适的付款请求。
NeroPOS
柜台内外
将您的现场服务与更广泛的 NeroPay 体验连接起来,从收银台的订单到支持的刷卡支付。
我需要自己构建卡片支付表单吗?
不需要。API 会创建一个由 NeroPay 托管的支付页面。您的网站负责购物车并将客户重定向至结账页面;卡片详情在托管页面输入。
连接现有网站需要开发人员吗?
自定义 API 集成通常需要开发人员。如果您不需要自定义购物车,Link Payments、Invoice Payments 和 NeroForm 提供其他支付请求方式。
我在哪里可以找到 API 参考?
NeroPay API v2 参考包含请求字段、认证详情、示例及支付通知指南。构建集成时请使用最新参考。
我的网站应如何确认订单已支付?
使用服务器端验证的支付结果,并匹配订单编号和金额。不要仅因结账页面打开或客户返回成功 URL 即履行订单。
线上和线下支付可以使用同一个 NeroPay 账户吗?
可以。您的 NeroPay 账户可以支持在线支付工具以及已启用的线下支付设置。可用方式和账户要求取决于您的业务和地区。
API 示例中的金额是什么意思?
示例使用主要货币单位:15.99 表示当货币为 GBP 时的 £15.99。请始终遵循端点文档中的金额格式。
我在哪里可以查看费用和结算详情?
查看当前 NeroPay 价格及您的账户条款。客户成功付款和资金可用于支付是两个不同阶段;不要承诺结账响应即可即时到账。
为您的网站打造值得完成的支付流程。
探索托管结账,查看 API 参考,选择适合您业务的在线支付设置。