← 返回首页
梨界支付中心 · 开发文档

接入文档

梨界支付中心是梨界矩阵内部的统一支付网关。业务后端通过 HMAC 签名调用统一 API，不直接对接微信 / 支付宝；支付凭据集中托管，业务系统只持有 site 级 hmac_secret。

接入指南必读

完整接入文档

HMAC 签名 → 创建订单 → 接收回调的完整流程，含 5 个核心 API、错误码表、Node/Python/PHP SDK 模板、上线检查清单。

MARKDOWN给 AI 用

文档 raw markdown

原始 markdown 文件，可 curl / fetch 拉到 AI 助手，让 AI 自动生成接入代码。

API SCHEMA机读

OpenAPI 规范

完整的 OpenAPI 3.0 JSON。可导入 Postman / Insomnia / OpenAPI Generator。

LLMAI 一键

LLM 友好版

给 AI 助手的浓缩 Quick Start。复制提示词模板让 ChatGPT / Claude 一键生成完整 SDK + callback。

DEVELOPER后台

开发者中心 (后台)

登录后台后查看：HMAC 在线调试器、SDK 复制、近期 API 调用日志、回调日志。需要管理员权限。

HEALTH运维

健康检查

进程存活：/healthz · 依赖检查（DB / Redis / 配置）：/readyz

5 步接入流程

  1. 1

    联系管理员注册 site

    提供产品名称 + callback URL（如 https://业务域名/api/internal/pay-callback）

  2. 2

    拿到 site_code + hmac_secret

    .env 配置 LJ_PAY_BASE_URL / LJ_PAY_SITE_CODE / LJ_PAY_HMAC_SECRET

  3. 3

    实现 SDK

    复制 docs/integration 里的 Node/Python/PHP 模板，~80 行搞定

  4. 4

    实现 callback endpoint

    验签 + 校验金额 + 幂等 + 标已支付。必须返回 200 + {ok:true}

  5. 5

    ¥0.01 端到端联调

    真账号付 0.01，看 dashboard / 日志确认流程通