NATSpayment.method.add绑定支付方式

Try it 面板需要启用 JavaScript。

以渠道临时 token 绑定支付方式；原文凭据经渠道直达 payment_service 内部，永不外传。

Request Payload

消息格式：JSON

Name	Data Type	Required	Description
userId	string	Yes	用户 ID
providerToken	string	Yes	渠道临时 token（一次性）
setAsDefault	boolean	No	是否设为默认

type RequestBody = {
  /** 用户 ID */
  userId: string
  /** 渠道临时 token（一次性） */
  providerToken: string
  /** 是否设为默认 */
  setAsDefault?: boolean
}

{
  "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "providerToken": "pm_tok_1N0sXe2mYq7Ld4Rw",
  "setAsDefault": true
}

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	成功	绑定支付方式
2801	渠道 token 无效
2802	支付方式被渠道拒绝

Examples

{ "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C", "providerToken": "pm_tok_1N0sXe2mYq7Ld4Rw", "setAsDefault": true }

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