POST/api/v1/me/payment-methods/:methodId/default设为默认支付方式

Try it 面板需要启用 JavaScript。

将指定支付方式设为默认，原默认自动降级。

Request

Headers

Name	Data Type	Required	Description
Authorization	string	Yes	会话令牌认证，格式 `Bearer <sessionToken>`

type RequestHeaders = {
  /** 会话令牌认证，格式 `Bearer <sessionToken>` */
  Authorization: string
}

URL Parameters

Name	Data Type	Description
methodId	string	支付方式 ID

Response

Body

PaymentMethodDTO

Name	Data Type	Required	Description
methodId	string	Yes	支付方式 ID
brand	string	Yes	品牌（visa / mastercard / alipay 等）
maskedNumber	string	Yes	脱敏尾号，如 **** 4242
expiry	string	No	有效期（MM/YY，卡片类才有）
isDefault	boolean	Yes	是否默认支付方式
addedAt	string	Yes	绑定时间

type PaymentMethodDTO = {
  /** 支付方式 ID */
  methodId: string
  /** 品牌（visa / mastercard / alipay 等） */
  brand: string
  /** 脱敏尾号，如 **** 4242 */
  maskedNumber: string
  /** 有效期（MM/YY，卡片类才有） */
  expiry?: string
  /** 是否默认支付方式 */
  isDefault: boolean
  /** 绑定时间 */
  addedAt: string
}

{
  "methodId": "01JD8SNR8N0S3W9ZS4W7ZFM1X5G",
  "brand": "visa",
  "maskedNumber": "**** 4242",
  "expiry": "09/28",
  "isDefault": true,
  "addedAt": "2026-10-14T11:40:00Z"
}

HTTP Code

HTTP Status	Meaning	Notes
200	成功	返回设为默认后的支付方式

Response Code

响应使用统一信封 {id, code, messages, result}，其 code 字段：

code	Meaning	Notes
0	成功	返回设为默认后的支付方式

Examples

POST /api/v1/me/payment-methods/01JD8SNR9N1T4W0AT5X8AGN2Y5H/default
Authorization: Bearer st_7c1f9e05b28d4a63

{
  "id": "01JD8SONUH2H4P1",
  "code": 0,
  "messages": [],
  "result": {
    "methodId": "01JD8SNR9N1T4W0AT5X8AGN2Y5H",
    "brand": "visa",
    "maskedNumber": "**** 4242",
    "expiry": "09/28",
    "isDefault": true,
    "addedAt": "2026-10-14T11:50:00Z"
  }
}