Card Issuance
卡发行
虚拟卡与实体卡全生命周期：产品与 BIN、开卡、充值到卡、卡内转出、消费管控、查看卡密、销卡与补换。
指南
卡发行概述用会员的 L1 资料在上游开卡，从他的资产余额充值到卡，全球消费。卡产品与 BIN卡产品决定 BIN、币种、形态与限额硬顶。清单是我方按商户授权给的。开卡申请 → 审核 → 开卡。实体卡多绑卡与激活两步，且激活不可逆。充值到卡与卡内转出充值到卡是两段异步 —— 下单成功不等于钱到卡了。消费管控限额、商户/MCC 名单、账单地址 —— 三种管控，白名单与黑名单不能就地互改。冻结、挂失与销卡冻结与解冻是**两个**过渡态；销卡不可逆且必须先清空卡内资金。查看卡密卡密只在我方域内渲染一次 —— 你的页面永远拿不到它，这是刻意的。拒付拒付罚金是**你对你会员**的风控手段 —— 我方只看你的整体拒付率。状态机与取值四条状态轴各自独立推进 —— 申请单、卡片、物流、补件。这一页是它们的全集。
Webhook
API 参考 · 40 个端点
卡产品 Products
GET
/v1/cards/products
可申请的卡产品（按商户授权的 BIN 过滤）
GET
/v1/cards/products/{id}/quote
开卡发票 —— 这一款卡对这个会员的报价与准入
开卡申请 Applications
POST
/v1/cards/applications
提交开卡申请（虚拟/实体经 form_factor 区分）
动钱
GET
/v1/cards/applications/{id}
申请状态
GET
/v1/cards/applications/{id}/cancel-preview
取消预览（能不能取消 · 退多少）
POST
/v1/cards/applications/{id}/cancel
取消申请（唯一的自助止损路径）
动钱
POST
/v1/cards/applications/{id}/supplement-sessions
补件 —— 换一张托管屏链接给终端用户
GET
/v1/cards/applications/{id}/shipment
实体卡物流（四条状态轴之一，不由其余派生）
卡片 Cards
GET
/v1/cards
卡列表（前六后四，永不含完整卡号）
GET
/v1/cards/{id}
卡详情（前六后四，永不含完整卡号）
PATCH
/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
GET
/v1/cards/{id}/replacement
补卡进度与补卡报价（互斥的两块）
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 那一支）
邮寄地址簿 Shipping Addresses
GET
/v1/shipping-addresses
邮寄地址簿
POST
/v1/shipping-addresses
新增邮寄地址
GET
/v1/shipping-addresses/{id}
单条地址
PATCH
/v1/shipping-addresses/{id}
修改地址内容
DELETE
/v1/shipping-addresses/{id}
删除地址
POST
/v1/shipping-addresses/{id}/default
设为默认