NATSpayment.method.set-default设为默认支付方式

Try it 面板需要启用 JavaScript。

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

Request Payload

消息格式：JSON

Name	Data Type	Required	Description
userId	string	Yes	用户 ID
methodId	string	Yes	支付方式 ID

type RequestBody = {
  /** 用户 ID */
  userId: string
  /** 支付方式 ID */
  methodId: string
}

{
  "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "methodId": "01JD8SNR9N1T4W0AT5X8AGN2Y5H"
}

Response Payload

回复使用统一信封 {id, code, messages, result}，其 result：

Name	Data Type	Required	Description
methodId	string	Yes	支付方式 ID
brand	string	Yes	品牌
maskedNumber	string	Yes	脱敏尾号
isDefault	boolean	Yes	是否默认
addedAt	string	Yes	绑定时间

type ResponseBody = {
  /** 支付方式 ID */
  methodId: string
  /** 品牌 */
  brand: string
  /** 脱敏尾号 */
  maskedNumber: string
  /** 是否默认 */
  isDefault: boolean
  /** 绑定时间 */
  addedAt: string
}

{
  "methodId": "01JD8SNR9N1T4W0AT5X8AGN2Y5H",
  "brand": "visa",
  "maskedNumber": "**** 4242",
  "isDefault": true,
  "addedAt": "2026-10-14T11:50:00Z"
}

Response Code

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

code	Meaning	Notes
0	成功	设为默认支付方式

Examples

{ "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C", "methodId": "01JD8SNR9N1T4W0AT5X8AGN2Y5H" }

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