LsPay
登录 免费注册
Docs

标准接口、接入流程和联调要点都在这里。

这里提供对外文档概览。更完整的参数说明、示例代码和商户配置项可在登录后进入开发者中心查看。

Guide 接入流程
Quick Start
接入建议按这个顺序走。

1. 获取商户密钥

商户注册后进入开发者中心，获取 API Key、API Secret 和默认回调配置。

Credentials

2. 配置支付通道

在通道配置中补充支付方式、通知地址、查询方式和对应密钥信息。

Gateway

3. 发起订单与验证回调

优先依赖异步通知作为支付成功依据，查询接口只作为兜底，不建议仅依赖前端返回页判断。

Notify
Native API
原生接口按真实路由和真实签名规则给出。
这里不再写抽象描述，直接对应当前代码里的可用入口。默认 Base URL 为 https://pay.lsttt.com/api/v1，认证使用 Header，业务参数参与大写 MD5 签名。
Endpoints
当前开放接口
接口 方法 路径 说明
创建订单 POST /api/v1/pay/create 返回支付页地址和当前通道参数
查询订单 POST /api/v1/pay/query 支持 order_no 或 merchant_order_no
关闭订单 POST /api/v1/pay/close 仅待支付订单可关闭
发起退款 POST /api/v1/pay/refund 依赖上游退款网关已配置
查询余额 POST /api/v1/merchant/balance 获取商户可用余额
通道列表 POST /api/v1/channel/list 返回商户当前可用通道及可用性说明
Request
创建订单示例
POST https://pay.lsttt.com/api/v1/pay/create
X-Api-Key: lsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
X-Timestamp: 1773817800
X-Sign: 9A0F4A7B6F...
Content-Type: application/json

{
  "merchant_order_no": "ORDER202603180001",
  "channel_code": "apple_pay",
  "amount": "128.00",
  "subject": "会员充值",
  "body": "季度会员充值",
  "notify_url": "https://merchant.example.com/notify",
  "return_url": "https://merchant.example.com/return",
  "param": "user_1001"
}
Response
成功响应示例
{
  "code": 0,
  "msg": "success",
  "data": {
    "order_no": "202603181234567890",
    "amount": "128.00",
    "pay_url": "https://pay.lsttt.com/pay/p/202603181234567890",
    "expire_time": 1773817920,
    "pay_params": {
      "pay_type": "apple_pay"
    }
  },
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "timestamp": 1773817800
}
Launch Prep
上线前把资料、通知和通道准备完整。
对外文档只保留通用说明。实际联调时，请在后台按支付方式补全对应资料、回调和退款配置，确保收款与售后链路完整可用。
Merchant Info
建议提前准备

商户凭据

准备商户编号、API Key、API Secret，并确认业务系统的下单来源域名。

回调地址

确认异步通知地址、返回地址和问题排查的联系人信息，避免上线后找不到接收方。

售后流程

提前确认退款规则、订单查询口径和对账方式，便于后续运营处理。

Channel Setup
通道配置重点
1. 选择需要开通的支付方式
2. 补全对应商户资料与证书
3. 配置通知、查询和退款规则
4. 完成测试支付与回调验收
5. 再切换到正式环境

建议把支付资料、域名证书、异步通知和退款流程一起检查，避免只开通下单能力却遗漏售后链路。

Apple Pay
需要完成商户与域名验证

请准备可用域名、商户资料与证书，先完成域名验证，再进行收款联调。

支付宝
确认通知与退款规则

建议同步确认支付通知、订单查询与退款处理方式，保证收款和售后体验一致。

微信支付
保持收款方式与场景匹配

根据业务场景选择 H5、扫码或其他合适方式，并在正式上线前完成支付、通知和退款验收。

上线前至少做完四项联调。

1. 支付成功以异步通知为准。2. 不同设备各做一次完整支付测试。3. 退款和查询流程至少验证一遍。4. 正式环境资料、通知地址和联系人全部确认无误。