Consumer API

面向业务系统的卡产品、钱包、卡片与交易接口。
45 个接口 · 5 个业务域 · RSA-SHA256 · JSON

Base URL

https://api.lampay.app

准备接入配置：取得 API Key、API 调用地址和工作台 ID（Workspace ID）。

准备签名密钥：使用与已注册客户端公钥匹配的 RSA 私钥；私钥仅保存在调用方服务端。

完成首个只读请求：建议先查询卡产品或钱包，确认网络、签名和权限配置正确。

接入写操作：开卡、资金划转及卡状态操作前，先阅读接口状态约束并处理异步结果。

安全提示：RSA 私钥，不得放入浏览器、移动端、日志或公开仓库。

签名原文按以下顺序使用换行符连接：

METHOD
PATH
CANONICAL_QUERY
TIMESTAMP
NONCE
SHA256(RAW_BODY)

请求体哈希必须基于实际发送的原始字节计算。请保持服务器时间同步，并为每次重试生成新的时间戳、Nonce 和签名。

标准响应由 version、timestamp、success、code、message 和 data 组成。调用方应同时判断 HTTP 状态码与 success，并保留 code 用于错误分支处理。

列表或分页接口适合定位业务对象，详情接口适合读取最新状态。

开卡和资金划转可能经历异步状态流转；受理成功不等于业务已完成。

写操作重试前，请确认目标接口的幂等要求和对象当前状态。

卡敏感信息仅可在明确授权的服务端流程中读取，不得写入日志或长期保存。

左侧目录使用中文业务分类，接口名保留英文，以便与 SDK、请求路径及错误排查信息保持一致。