LiliPay 支付接口文档

网关地址:https://api.lilipay.lol

签名类型:MD5 / RSA(默认 MD5)

💸 alipay 支付宝 💬 wxpay 微信 🐧 qqpay QQ钱包

1页面跳转支付接口

接口地址

/submit.php

请求方式

GET 或 POST

请求参数

参数名必填说明
pid商户ID
type支付方式(alipay/wxpay/qqpay),不填则显示收银台
out_trade_no商户订单号(唯一)
notify_url服务器异步通知地址
return_url页面跳转通知地址
name商品名称
money订单金额(单位:元)
param业务扩展参数(原样返回)
sign签名字符串
sign_type签名类型(MD5/RSA),默认 MD5

请求示例

https://api.lilipay.lol/submit.php?pid=LP28&type=alipay&money=100&notify_url=https://example.com/notify&return_url=https://example.com/return&out_trade_no=20240101123456&name=商品名称&sign=签名&sign_type=MD5

返回顶部 ↑

2API创建订单接口

接口地址

/mapi.php

请求方式

GET 或 POST

请求参数

与页面跳转支付接口参数完全一致,请参考 页面跳转支付接口 的参数表。

请求示例

POST https://api.lilipay.lol/mapi.php
Content-Type: application/x-www-form-urlencoded

pid=LP28&type=alipay&money=100&notify_url=https://example.com/notify&return_url=https://example.com/return&out_trade_no=20240101123456&name=商品名称&sign=签名&sign_type=MD5

说明

与页面跳转支付接口参数完全一致,区别在于 mapi.php 返回 JSON 数据而非跳转页面。

成功返回

{"code":1,"msg":"success","trade_no":"平台订单号","payurl":"支付地址"}

返回中也可能是 qrcodeurlscheme 字段。

返回顶部 ↑

3查询订单接口

接口地址

/api.php?act=order

请求方式

GET / POST

请求参数

参数名必填说明
act此 API 固定值:order
pid商户ID
key商户密钥
trade_no二选一系统订单号(与 out_trade_no 二选一)
out_trade_no二选一商户订单号(与 trade_no 二选一)

说明

trade_noout_trade_no 二选一传入即可,都传入时以 trade_no 为准。

响应示例

{
  "code": 1,
  "msg": "success",
  "trade_no": "平台订单号",
  "out_trade_no": "商户订单号",
  "api_trade_no": "第三方订单号",
  "type": "alipay",
  "pid": 1001,
  "addtime": "2024-01-01 12:00:00",
  "endtime": "2024-01-01 12:05:00",
  "name": "商品名称",
  "money": "1.00",
  "status": 1,
  "param": "业务扩展参数",
  "buyer": "支付者账号"
}

返回字段说明

字段名变量名类型说明
返回状态码codeInt1 为成功,其它值为失败
返回信息msgString返回信息
系统订单号trade_noString平台订单号
商户订单号out_trade_noString商户系统内部的订单号
第三方订单号api_trade_noString支付宝微信等接口方订单号
支付方式typeStringalipay/wxpay/qqpay/bank
商户IDpidInt发起支付的商户ID
创建时间addtimeString创建订单时间
完成时间endtimeString完成交易时间
商品名称nameString商品名称
商品金额moneyString商品金额
支付状态statusInt1 为支付成功,0 为未支付
业务扩展参数paramString默认留空
支付者账号buyerString默认留空

状态码说明

状态码说明
0未支付
1支付成功

注意事项

返回顶部 ↑

4签名规则

MD5 签名

  1. 将所有非空参数(排除 signsign_type)按字母升序排列
  2. 拼接成 key=value&key2=value2 格式
  3. 在末尾直接拼接 API 密钥(不加 &key= 前缀)
  4. 进行 MD5 加密,转为小写

签名示例 —— 参数

money=0.01
name=商品名称
notify_url=https://example.com/notify
out_trade_no=20240101123456
pid=LP28
return_url=https://example.com/return
type=alipay

拼接后(末尾直接拼接密钥)

money=0.01&name=商品名称&notify_url=https://example.com/notify&out_trade_no=20240101123456&pid=LP28&return_url=https://example.com/return&type=alipayLPulOyEz0mA1KBjgO5bgyFFnysZqSPPU

MD5 加密后(小写)

a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

RSA 签名

  1. 将所有非空参数按字母升序排列
  2. 拼接成 key=value&key2=value2 格式
  3. 使用 RSA 私钥进行签名
  4. 将签名结果进行 Base64 编码

返回顶部 ↑

5异步通知

通知方式

GET

通知时间

支付成功后立即通知

通知参数

参数名必填说明
pid商户ID
trade_no平台订单号
out_trade_no商户订单号
type支付方式(alipay/wxpay/qqpay)
name商品名称
money订单金额(单位:元)
trade_status交易状态(TRADE_SUCCESS)
param业务扩展参数(原样返回)
sign签名字符串
sign_type签名类型(MD5)

通知示例

GET 您的异步通知地址?pid=商户ID&trade_no=平台订单号&out_trade_no=商户订单号&type=alipay&name=商品支付&money=100.00&trade_status=TRADE_SUCCESS&param=扩展参数&sign=签名&sign_type=MD5

注意事项

返回顶部 ↑

6同步跳转

跳转方式

GET

跳转时间

支付成功后立即跳转

跳转参数

参数名必填说明
pid商户ID
trade_no平台订单号
out_trade_no商户订单号
type支付方式(alipay/wxpay/qqpay)
name商品名称
money订单金额(单位:元)
trade_status交易状态(TRADE_SUCCESS)
param业务扩展参数(原样返回)
sign签名字符串
sign_type签名类型(MD5)

跳转示例

您的同步跳转地址?pid=商户ID&trade_no=平台订单号&out_trade_no=商户订单号&type=alipay&name=商品支付&money=100.00&trade_status=TRADE_SUCCESS&param=扩展参数&sign=签名&sign_type=MD5

注意事项

返回顶部 ↑

7状态码说明

状态码说明
0未支付
1支付成功

返回顶部 ↑

8通用注意事项

返回顶部 ↑