Enroll Card in Network Protection
将卡片注册到 ASAF(Account & Cardholder Fraud Solution)Network Protection。
使用此接口可将丢失、被盗、过期或已关闭的卡片注册到 Visa 网络,使其后续的授权尝试在全网范围内被拒绝。注册请求为异步——响应确认请求已受理,最终结果通过 card.risk_control.network_protection.enrolled webhook 送达。
授权
由 UQPay 提供的登录 API Token。
请求头
指定代表哪个子账户发起请求。应设置为 account_id,该值可通过 List Connected Accounts 接口获取。若省略或为空,则请求以主账户身份执行。
更多信息参见 关联账户。
用于维持操作幂等性的唯一标识符(UUID),确保同一操作的重复执行不会产生意外影响或重复。它有助于在网络错误、重试或失败的情况下保持数据一致性。
路径参数
资源的全局唯一标识符(UUID v4)。
"71fdb0fe-9682-457a-9361-e8868694f12f"
请求体
响应
注册请求已受理。
针对 ASAF Network Protection 注册或移除请求返回的确认信息。
卡片的唯一标识符。
"7f6dbbd9-37b9-4f64-a021-cd4f71234567"
脱敏卡号。
"************1234"
持卡人的唯一标识符。
"b6e6268b-7d95-4700-9b87-12e7c1234567"
卡组织。
"VISA"
该卡片当前是否启用了 Network Protection。此字段反映请求被网络处理后的状态——由于注册和移除是异步的,它可能不会立即变化。
false
ASAF Network Protection 注册的生命周期状态。
NOT_ENROLLED, ENROLL_PENDING, ENROLL_FAILED, ENROLLED, REMOVAL_PENDING "ENROLL_PENDING"
ASAF 操作码,表示卡片被注册到 Network Protection 的原因。
04—— 收卡41—— 卡片挂失,收卡43—— 卡片被盗,收卡46—— 账户已关闭54—— 卡片已过期
04, 41, 43, 46, 54 "41"
action_code 的可读描述。
"Lost card, pickup"
注册或移除请求最后一次更新的时间。
"2026-05-14T09:00:00Z"

