Card Issuance
卡发行
虚拟卡与实体卡全生命周期:产品与 BIN、开卡、充值到卡、卡内转出、消费管控、查看卡密、销卡与补换。
指南
本产品的指南尚未撰写
见 PROGRESS.md 的 T2 批次表。这一段是空的、而不是不存在 ——
隐藏它的话下一批的人看不出这里本来就该有内容。
API 参考 · 27 个端点
卡产品 Products
开卡申请 Applications
POST
/v1/cards/applications
提交开卡申请(虚拟/实体经 form_factor 区分)
动钱
GET
/v1/cards/applications/{id}
申请状态
GET
/v1/cards/applications/{id}/shipment
实体卡物流(四条状态轴之一,不由其余派生)
卡片 Cards
GET
/v1/cards
卡列表(前六后四,永不含完整卡号)
GET
/v1/cards/{id}
卡详情(前六后四,永不含完整卡号)
GET
/v1/cards/{id}/transactions
卡消费流水(游标分页)
卡内资金 Funding
POST
/v1/cards/{id}/topup-quotes
充值到卡试算(不外呼上游)
POST
/v1/cards/{id}/topups
充值到卡(两段异步:到卡以 webhook 为准)
动钱
POST
/v1/cards/{id}/withdrawals
卡内资金转出到钱包(≠ 链上提现)
动钱
消费管控 Controls
POST
/v1/cards/{id}/freeze
冻结卡片(过渡态 freezing)
POST
/v1/cards/{id}/unfreeze
解冻卡片(过渡态 unfreezing,与冻结分开的端点)
PATCH
/v1/cards/{id}/limits
设置用户自定义限额(0 = 未自设,落到产品上限)
GET
/v1/cards/{id}/merchant-rules
读这张卡的商户 / MCC 名单
PUT
/v1/cards/{id}/merchant-rules
整份替换商户 / MCC 名单(白名单或黑名单,二选一)
DELETE
/v1/cards/{id}/merchant-rules
清空这张卡的名单(恢复成不受限)
PATCH
/v1/cards/{id}/billing-address
改账单地址(美国线上商户 AVS 校验的对象)
生命周期 Lifecycle
POST
/v1/cards/{id}/lost
挂失 / 报盗卡(不可逆,仅实体卡)
GET
/v1/cards/{id}/close-check
销卡预检(必须先清空卡内资金)
POST
/v1/cards/{id}/close
销卡(不可逆)
POST
/v1/cards/{id}/replacements
补/换卡申请(余额不在新旧卡之间直接转)
实体卡 Physical Cards
POST
/v1/cards/bind
绑定实体卡(三要素;不挂强认证)
POST
/v1/cards/{id}/activate
激活实体卡(挂强认证且不可逆)
POST
/v1/cards/{id}/pin
改 / 重置 PIN(忘了旧 PIN 走 CVV 那一支)