查询二维码支付

按二维码支付 ID 查询当前商户的二维码支付详情。资源不存在或不属于当前商户时统一返回 404。

二维码支付不存在或不属于当前商户时统一返回 404 resource_not_found。

GET /api/v1/customer-deposits/{deposit_session_id}

200

{
  "deposit_session_id": "<string>",
  "customer_id": "<string>",
  "status": "active",
  "allow_multiple_deposits": true,
  "expires_at": 123,
  "url": "<string>",
  "metadata": {},
  "created": 123
}

授权

Authorization · string · header · 必填

Bearer API Key，例如 Bearer sk_live_xxx。

X-StablePay-Timestamp · string · header · 必填

Unix 时间戳（秒）。必须与服务端时间相差不超过 5 分钟。

X-StablePay-Nonce · string · header · 必填

防重放随机字符串，长度 16-64 个字符。

X-StablePay-Signature · string · header · 必填

使用商户 API Secret 计算的 HMAC-SHA256 小写 hex 签名。

请求头

X-StablePay-Timestamp · string · 必填

Unix 时间戳（秒）。必须与服务端时间相差不超过 5 分钟。

X-StablePay-Nonce · string · 必填

防重放随机字符串，长度 16-64 个字符，建议每次请求使用新的 UUID。

Required string length: 16 - 64

X-StablePay-Signature · string · 必填

使用商户 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256，结果为小写 hex。GET 请求的 requestBody 为空字符串。

路径参数

deposit_session_id · string · 必填

二维码支付 ID。

Minimum string length: 1

响应

200

application/json

查询成功。

deposit_session_id · string · 必填

二维码支付 ID。

customer_id · string · 必填

StablePay 客户 ID。

status · enum<string> · 必填

二维码支付状态。

可用选项: active, closed, expired

allow_multiple_deposits · boolean · 必填

是否允许使用同一个二维码支付链接多次支付。

expires_at · integer<int64> | null · 必填

过期时间，Unix 秒；永久有效时固定返回 null。

url · string<uri> · 必填

托管收银台 URL。

metadata · object · 必填

商户自定义元数据。

Show child attributes

created · integer<int64> · 必填

创建时间，Unix 秒。