跳转到主要内容
POST
Enroll Card in Network Protection

授权

x-auth-token
string
header
必填

由 UQPay 提供的登录 API Token。

请求头

x-on-behalf-of
string

指定代表哪个子账户发起请求。应设置为 account_id,该值可通过 List Connected Accounts 接口获取。若省略或为空,则请求以主账户身份执行。 更多信息参见 关联账户

x-idempotency-key
string<uuid>
必填

用于维持操作幂等性的唯一标识符(UUID),确保同一操作的重复执行不会产生意外影响或重复。它有助于在网络错误、重试或失败的情况下保持数据一致性。

路径参数

id
string<uuid>
必填

资源的全局唯一标识符(UUID v4)。

示例:

"71fdb0fe-9682-457a-9361-e8868694f12f"

请求体

application/json
risk_control
enum<string>
必填

风控类型。ASAF 注册时必须为 network_protection

可用选项:
network_protection
示例:

"network_protection"

action_code
enum<string>
必填

ASAF 操作码,表示卡片被注册到 Network Protection 的原因。

  • 04 —— 收卡
  • 41 —— 卡片挂失,收卡
  • 43 —— 卡片被盗,收卡
  • 46 —— 账户已关闭
  • 54 —— 卡片已过期
可用选项:
04,
41,
43,
46,
54
示例:

"41"

响应

200 - application/json

注册请求已受理。

针对 ASAF Network Protection 注册或移除请求返回的确认信息。

card_id
string<uuid>

卡片的唯一标识符。

示例:

"7f6dbbd9-37b9-4f64-a021-cd4f71234567"

card_number
string

脱敏卡号。

示例:

"************1234"

cardholder_id
string<uuid>

持卡人的唯一标识符。

示例:

"b6e6268b-7d95-4700-9b87-12e7c1234567"

card_scheme
string

卡组织。

示例:

"VISA"

enabled
boolean

该卡片当前是否启用了 Network Protection。此字段反映请求被网络处理后的状态——由于注册和移除是异步的,它可能不会立即变化。

示例:

false

status
enum<string>

ASAF Network Protection 注册的生命周期状态。

可用选项:
NOT_ENROLLED,
ENROLL_PENDING,
ENROLL_FAILED,
ENROLLED,
REMOVAL_PENDING
示例:

"ENROLL_PENDING"

action_code
enum<string>

ASAF 操作码,表示卡片被注册到 Network Protection 的原因。

  • 04 —— 收卡
  • 41 —— 卡片挂失,收卡
  • 43 —— 卡片被盗,收卡
  • 46 —— 账户已关闭
  • 54 —— 卡片已过期
可用选项:
04,
41,
43,
46,
54
示例:

"41"

definition
string

action_code 的可读描述。

示例:

"Lost card, pickup"

update_time
string<date-time> | null

注册或移除请求最后一次更新的时间。

示例:

"2026-05-14T09:00:00Z"