SuperAPI AI 工具集

setup-lekirpay

编程与开发

查看项目

更新于 11-17 02:09

技能介绍

用途

该技能面向 LekirPay 支付网关(Lekir Tech (M) Sdn Bhd)的集成工作,可用于搭建、构建、调试、审查和解释相关支付集成代码。使用前应先阅读 references/lekirpay-api.md,其中包含端点目录、基础 URL、令牌流程、完整请求/响应字段表、Lekir-Signature 校验和算法及已验证示例、回调字段、状态值和文档缺口;当涉及注册、凭据位置、沙箱与生产、环境变量名、支付方式、退款、结算或定价时,阅读 references/account-setup.md;选择官方页面时参考 references/source-map.md。

主要能力与核心流程

  1. 识别环境:沙箱(https://sandbox.lekirpay.com)或生产(https://app.lekirpay.com),并确认沙箱主机可响应。
  2. 确认商户资料已通过验证,未验证资料会被支付 API 拒绝。
  3. 从仪表盘 API 标签获取凭据:ID(client_id)、Lekirkey(client_secret)、Lekir-Signature 密钥。
  4. 在本地创建待处理支付,使用唯一 reference_no(最长 140 字符)和精确金额字符串。
  5. 请求 Bearer 令牌:POST /oauth/token,grant_type=client_credentials、client_id、client_secret,并在服务端缓存(文档标明 expires_in 为 1296000 秒,即 15 天)。
  6. 在服务端创建支付:首选 POST /api/payments/payment/secure(发送校验和),或 POST /api/payments/payment。
  7. 保存 payment_id,将客户重定向至 payment_url。
  8. 收到 callback_url 的 POST 及 redirect_url 返回时,将载荷视为不可信(无文档化签名)。
  9. 使用 Bearer 令牌调用 GET /api/payments/{payment_id}/status 重新查询,仅当状态为 Paid 且 payment_id、reference_no、amount 与本地记录一致时结算。
  10. 幂等结算;回调、跳转和手动重查可能对同一笔支付多次到达。

关键事实

生产 API 基础地址为 https://app.lekirpay.com/api;沙箱 API 基础地址(文档)为 https://sandbox.lekirpay.com/api。令牌端点为 POST https://app.lekirpay.com/oauth/token,响应含 token_type(Bearer)、expires_in、access_token。创建支付端点为 POST /api/payments/payment,签名变体为 POST /api/payments/payment/secure。创建支付必填字段:item、amount、reference_no、callback_url、email、name,/secure 另需 checksum。创建响应含 payment_id、reference_no、payment_url、status(created)、created_date。校验和算法为 HMAC-SHA256(十六进制),使用 Lekir-Signature 密钥,按 amount{amount}|email{email}|item{item}|name{name}|callback_url{callback_url}|reference_no{reference_no} 的固定顺序计算。回调包含 payment_id、reference_no、trx_no、merchant_name、amount、name、email、phone、item、timestamp、payment_method、status、type(callback 或 redirect)。状态重查接口为 GET /api/payments/{payment_id}/status,状态值有 Created、Proceed、Paid、Failed。method(GET 或 POST,默认 POST)控制数据发送至跳转的方式。金额为林吉特小数,非分;网站声明仅支持 MYR。API 接受 application/x-www-form-urlencoded 和 application/json,文档化 HTTP 状态码为 200 和 400。支付组接口为 POST /api/payment_group/create 与 GET /api/payment_group/data,创建支付时可传 group_id。文档未提供退款、定期扣款、令牌化或 webhook 签名 API。

关键规则

client_secret(Lekirkey)、Lekir-Signature 密钥和访问令牌只能保留在服务端。不得仅凭回调体、redirect_url 命中或 POST 中的 status 标记为已支付,必须重查状态 API。状态比较应忽略大小写(创建响应为 created,官方插件检查为 Paid)。校验和字符串须使用实际发送的精确值构造(金额格式、带协议的 callback_url 一致),不要按字母顺序排序键,尽管文档文字提到“升序”。每次尝试的 reference_no 须唯一,并用于将回调映射回本地订单。回调应快速返回 HTTP 200,重查与结算须幂等。不要调用隐藏的批量出款或转账页面(lekirpay.co),其为遗留内容且主机无法解析。不要复制 GiveWP 插件的安全支付代码,因为它从不调用 /secure 且使用未定义的密钥变量。在宣称生产确定性之前,应向 LekirPay 核实当前沙箱可用性、套餐(卡支付需 Enterprise)与结算条款。

完成标准

令牌请求与支付创建在服务端运行,令牌缓存并在过期前刷新;重定向前存在带唯一 reference_no 和预期金额的本地待处理支付;若使用 /secure,checksum 按文档固定顺序字符串计算并针对文档示例做单元测试;回调与跳转处理器重查 GET /api/payments/{payment_id}/status 并核对 payment_id、reference_no、amount 与 Paid 状态;结算在回调、跳转和重试之间幂等;测试覆盖伪造回调(status 为 Paid 但 API 结果不同)、错误金额、错误 reference、Failed 状态、重复回调、过期令牌;部署文档列出 LEKIRPAY_BASE_URL、LEKIRPAY_CLIENT_ID、LEKIRPAY_CLIENT_SECRET、LEKIRPAY_SIGNATURE_KEY、回调 URL、跳转 URL 及沙箱/生产隔离。

漏洞审查循环

当被问及某 LekirPay 策略是否“100% 有信心”时,循环执行直至无事实缺口:列出信任边界(浏览器跳转、payment_url 页面、后端创建方、令牌缓存、LekirPay API、回调接收方、状态重查、数据库、履约任务、仪表盘设置);检查绕过路径(伪造回调 POST、带 status=Paid 的假跳转 POST、payment_id 被替换为其他商户订单、金额篡改、reference_no 重用、令牌过期、沙箱/生产混用、状态大小写敏感比较、重复回调、Paid 后到达 Failed 回调、未验证资料、套餐不含卡支付却使用卡支付);补充修复(服务端创建、本地待处理记录、仅以状态重查为真相、严格匹配 payment_id/reference_no/amount、payment_id 唯一约束、持久事件日志、令牌刷新、独立环境配置);重读相关参考章节;说明剩余不确定性:回调重试策略、预期回调响应、错误体结构、沙箱主机状态、退款流程和结算周期均未文档化。

适用场景与限制

适用于基于 LekirPay 的支付集成开发、代码审查、安全评估和问题排查,尤其是需要校验和签名、回调验证与幂等结算的服务端实现。限制在于:文档未提供退款、定期扣款、令牌化、webhook 签名、错误体结构、回调重试策略与结算周期等信息;沙箱可用性、套餐要求(卡支付需 Enterprise)与结算条款需向 LekirPay 核实。