跳转到主要内容
POST
/
api
/
v1
/
refunds
/
{refund_id}
/
cancel
{
  "refund_id": "<string>",
  "status": "canceled",
  "canceled_at": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.stablepayfi.ai/llms.txt

Use this file to discover all available pages before exploring further.

授权

​
Authorization
string
header
必填

Bearer API Key，例如 Bearer sk_live_xxx。

​
X-StablePay-Timestamp
string
header
必填

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

​
X-StablePay-Nonce
string
header
必填

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

​
X-StablePay-Signature
string
header
必填

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

请求头

​
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 为空字符串。

路径参数

​
refund_id
string
必填

商户创建退款时提供的唯一退款 ID。

响应

退款取消成功。

​
refund_id
string
必填

商户提供的退款单号。

​
status
enum<string>
必填
可用选项:
canceled
​
canceled_at
integer<int64>
必填

取消时间，Unix 秒。

Last modified on April 30, 2026