开发者中心

接入 NineLogix

当前 v1 接口仅接受 Store 范围的 Test 凭证。可创建测试订单、使用 NineLogix 托管结账并通过 API 查询状态；Live 凭证与真实支付路由仍由独立 Gate 控制。

快速开始

在商户后台获取测试 Merchant ID、Store ID 和一次显示的测试密钥。
为每个创建请求使用稳定的 Idempotency-Key。
把返回的 NineLogix checkout_url 交给客户。
通过查询接口或已验签 Webhook 确认最终状态。

curl https://www.ninelogix.com/api/v1/checkout-sessions \
  -H "Authorization: Bearer nlx_test_..." \
  -H "Idempotency-Key: order-demo-001" \
  -H "Content-Type: application/json" \
  -d '{"order_id":"demo-001","price_id":"nlx_price_approved"}'

认证 & 环境

使用 Bearer API Key。测试密钥以 nlx_test_ 开头，只能访问获批 scope；明文仅显示一次，NineLogix 只保存哈希。生产密钥单独审批，生成测试密钥不会开启生产交易。

Webhook

事件包含唯一 event_id 与时间戳。请对原始请求体计算 HMAC-SHA256、拒绝过期时间戳并进行恒定时间比较。浏览器返回页不决定最终支付状态。Test Webhook 使用可恢复的加密签名密钥、不可变事件与投递审计；重放只重投同一事件，绝不重试付款。

const expected = createHmac("sha256", secret)
  .update(timestamp + "." + rawBody)
  .digest("hex");
// Reject stale timestamps and compare signatures in constant time.

错误码与上线清单

401 invalid or missing API credential · 403 scope, environment or production approval missing · 409 state/idempotency conflict · 400 invalid request · 429 rate limited.

上线前确认：生产凭证获批、Store 与能力已激活、Return URL/Origin 已登记、Webhook 验签通过、幂等重放通过、生产 Gate 由管理员开启。

当前能力边界

Checkout 只接受已审批的 price_id。金额、币种、计费模型及可用支付方式来自 NineLogix 商品目录和 Store 能力分配。API 接入不授予退款、结算或 payout 操作。

数字产品能否出海俄罗斯？