开发者中心

面向工程团队的
集成体验

提供 RESTful API、Webhook 异步通知、沙箱测试环境与完整集成文档, 帮助团队快速完成真实支付接入。

沙箱环境不产生真实资金流转

POST /v1/payments
# 创建一笔真实支付请求
curl https://api.nexpay.com/v1/payments \
  -u "sk_test_xxx:" \
  -d merchant_order_no=ORDER-001 \
  -d amount=4900 \
  -d currency=USD \
  -d payment_methods[]=card \
  -d return_url=https://your-site.com/return \
  -d notify_url=https://your-site.com/webhook

# 响应示例
{
  "id": "pay_01HXXXXX",
  "status": "pending",
  "payment_url": "https://checkout.nexpay.com/s/xxx",
  "amount": 4900,
  "currency": "USD"
}
接入说明

清晰的接入路径,
降低开发复杂度

开发者可通过 RESTful API 完成真实支付请求创建、交易状态查询、Webhook 异步通知接收与退款处理。 平台提供标准字段结构与清晰的接入文档,适配主流开发流程。

01
申请沙箱账号
提交基础信息后开通测试环境
02
获取 API Key
在商户后台生成 Test / Live 密钥
03
对接支付 API
按文档接入支付创建与回调处理
04
上线切换 Live
完成联调后切换至生产环境
API 能力

围绕常见支付流程
设计的 API 能力

POST/v1/payments
创建支付
创建一笔支付订单并返回支付链接
GET/v1/payments/{id}
查询订单
按订单 ID 查询订单信息
GET/v1/payments/{id}/status
查询交易状态
获取订单最新交易状态
POST/v1/refunds
发起退款
对已支付订单发起全额或部分退款
GET/v1/billing/invoices
获取账单数据
查询订阅账单与结算数据
GET/v1/events
管理回调事件
查询 Webhook 事件与重推记录
Webhook

通过异步通知
同步关键交易状态

支持支付成功、支付失败、退款更新、订阅变更等事件通知, 帮助业务系统及时同步订单状态与后续处理动作。

payment.succeeded支付成功通知
payment.failed支付失败通知
refund.updated退款状态变更
subscription.updated订阅状态变更
POST /your-webhook
{
  "id": "evt_01HXXXXX",
  "type": "payment.succeeded",
  "created_at": 1713456789,
  "data": {
    "id": "pay_01HXXXXX",
    "merchant_order_no": "ORDER-001",
    "amount": 4900,
    "currency": "USD",
    "status": "succeeded",
    "paid_at": 1713456780
  },
  // 头部包含 X-NexPay-Signature,用于校验签名
}
沙箱测试

先测试,
上线

提供独立测试环境,帮助开发团队在上线前完成联调验证,减少正式环境接入风险。

隔离环境
沙箱与生产环境完全隔离,互不影响。
真实 API 结构
接口字段与生产环境保持一致,零切换成本。
测试支付流程
支持模拟支付成功、失败、退款等多种状态。
文档资源

从第一行代码到正式上线,
都有文档可查

系统运行正常

API 与 Webhook 服务运行中。如需查询实时状态与历史事件,欢迎联系我们的技术支持团队。