取消退款 - StablePay 文档

{
  "refund_id": "<string>",
  "status": "canceled",
  "canceled_at": 123
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "decline_code": "<string>",
    "request_log_url": "<string>",
    "charge": "<string>"
  },
  "request_id": "<string>",
  "timestamp": 123
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "decline_code": "<string>",
    "request_log_url": "<string>",
    "charge": "<string>"
  },
  "request_id": "<string>",
  "timestamp": 123
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "decline_code": "<string>",
    "request_log_url": "<string>",
    "charge": "<string>"
  },
  "request_id": "<string>",
  "timestamp": 123
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "decline_code": "<string>",
    "request_log_url": "<string>",
    "charge": "<string>"
  },
  "request_id": "<string>",
  "timestamp": 123
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "decline_code": "<string>",
    "request_log_url": "<string>",
    "charge": "<string>"
  },
  "request_id": "<string>",
  "timestamp": 123
}

POST

/

api

/

v1

/

refunds

/

{refund_id}

/

cancel

{
  "refund_id": "<string>",
  "status": "canceled",
  "canceled_at": 123
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "decline_code": "<string>",
    "request_log_url": "<string>",
    "charge": "<string>"
  },
  "request_id": "<string>",
  "timestamp": 123
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "decline_code": "<string>",
    "request_log_url": "<string>",
    "charge": "<string>"
  },
  "request_id": "<string>",
  "timestamp": 123
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "decline_code": "<string>",
    "request_log_url": "<string>",
    "charge": "<string>"
  },
  "request_id": "<string>",
  "timestamp": 123
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "decline_code": "<string>",
    "request_log_url": "<string>",
    "charge": "<string>"
  },
  "request_id": "<string>",
  "timestamp": 123
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "decline_code": "<string>",
    "request_log_url": "<string>",
    "charge": "<string>"
  },
  "request_id": "<string>",
  "timestamp": 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 个字符，建议每次请求使用新的 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 秒。

最后修改于 2026年4月30日