跳至内容
支付 · 在线支付

您的结账。
更清晰的支付方式。

将在线订单转变为简单的支付流程。将您的网站连接到 NeroPay,将客户引导到托管结账页面,并将结果带回您的业务流程中。

✓ 网站结账✓ API v2✓ 托管支付页面

为您的网站或应用程序打造。更喜欢即用型请求?请探索链接支付。

托管结账 · API v2预览
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
您的服务器→托管结账→支付结果
初始响应会创建一个结账网址,但不确认支付。
为您的客户清晰的金额和托管结账页面。
为您的开发者一次API请求即可创建支付页面。
为您的业务追踪结果,而不仅仅是点击。
超越柜台的支付

在线销售,让整个流程保持连贯。

为客户提供一种简便的支付方式,无需在自己的网站构建卡片输入流程。

适合您网站的结账页面

保持您自己的购物篮和订单体验。当客户准备好时创建支付页面,然后将他们重定向至NeroPay。

卡片输入留在托管的结账页面中

您的集成发送订单和客户信息,而非原始卡片详情。您的秘密API密钥保留在服务器端。

将结果带回您的工作流程

使用唯一订单参考号和支付通知端点,将支付结果与产生该订单的流程关联。

从购物篮到支付

从订单到结账的简便路径。

您的网站维护订单逻辑。NeroPay提供托管支付步骤。您的服务器在履约前确认结果。

1

创建订单

保存购物篮总额、客户信息及您自己的唯一参考号。最终金额由服务器控制。

2

创建托管结账

从您的服务器发送请求至API v2,并将客户引导至返回的结账网址。

3

确认并完成

处理服务器端的支付结果,将其与您的订单对账,并且仅处理一次履行。

探索流程

查看下一步。

订单已保存

在您的网站上保留购物篮。

您的服务器在创建结账之前计算应付金额并保存订单参考。

客户旅程£15.99
供您的开发人员使用

您的订单逻辑。
我们的托管结账。

从您的服务器创建支付页面。将客户发送到返回的结账网址,然后使用验证过的支付结果更新订单。

01
一次服务器端集成

示例使用 API v2 和主要货币单位:15.99 表示英镑中的 £15.99。

02
已认证并签名

将密钥保存在服务器端。使用最新的时间戳对您发送的准确 JSON 正文进行签名。

03
重试时不要创建新订单

将负载和幂等性密钥与订单一起持久保存。仅对完全相同的请求重用它们。

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中。

围绕真实销售设计

线上销售不止一种方式。

选择符合客户从您企业下单方式的在线支付路径。

网站订单

使用您现有的购物篮,将客户导向托管支付页完成最终结账步骤。

预约与定金

围绕约定的预订金额构建结账,并将支付参考与预订关联。

定制客户门户

为客户账户、服务订单或企业对企业工作流添加支付步骤。

您的网站,您的订单逻辑

让决策保留在应有的位置。

可靠的集成从明确的责任划分开始。您的网站定义订单;支付系统确认是否已支付。

在服务器端验证总价

不要相信浏览器提供的价格或客户编辑的订单参考。

将凭证保存在服务器端,避免放入浏览器

您的密钥、请求签名和支付结果验证应放在服务器端。

将重定向视为导航,而非支付证明

仅客户访问您的谢谢页面,不能单独确认支付成功。

合适的请求工具

一个账户。更多收款方式。

选择符合您的客户购买习惯的方式—而非千篇一律的支付流程。

连接业务的一部分

支付只是开始。

探索适合您业务服务客户方式的 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 表示当货币为 GBP 时的 £15.99。请始终遵循端点文档中的金额格式。

我在哪里可以查看费用和结算详情?

查看当前 NeroPay 价格及您的账户条款。客户成功付款和资金可用于支付是两个不同阶段;不要承诺结账响应即可即时到账。

为您的网站打造值得完成的支付流程。

探索托管结账,查看 API 参考,选择适合您业务的在线支付设置。