跳转到主要内容
请求支付退款。退款在处理前需经过审核流程。 
POST /v1/actions/refund-ticket/create-ticket
认证方式： API Key

​
请求体

字段类型必需说明
paymentIdstring是支付 ID（Short ID 格式 PAY_xxx）
reasonstring是退款请求原因
amountstring否部分退款金额的显示格式字符串（如 “15.00”）。省略则为全额退款

​
请求示例

// Full refund
const { ticket } = await client.orders.createRefundTicket({
  paymentId: "PAY_6eYCunG3IMmIgcQOnaXdoA",
  reason: "Product did not meet expectations",
});

// Partial refund
const { ticket } = await client.orders.createRefundTicket({
  paymentId: "PAY_6eYCunG3IMmIgcQOnaXdoA",
  reason: "Partial service used",
  amount: "15.00",
});

​
成功响应 (200)

{
  "data": {
    "ticketId": "TKT_8gAEwpI5KOoKieSQL1ZfqC",
    "status": "pending",
    "requestedAmount": "29.00"
  }
}

​
响应字段

字段类型说明
ticketIdstring退款工单 ID（Short ID 格式 TKT_xxx）
statusstring工单状态（初始为 pending）
requestedAmountstring退款金额的显示格式字符串

​
错误响应

状态码说明
400缺少 paymentId 或 reason
400退款窗口已过期（一次性产品为 7 天）
400部分退款金额超过原始支付金额
401认证失败
404支付未找到
500内部服务器错误