Card Issuance
卡发行
虚拟卡与实体卡全生命周期：产品与 BIN、开卡、充值到卡、卡内转出、消费管控、查看卡密、销卡与补换。
指南
卡发行概述用会员的 L1 资料在上游开卡，从他的资产余额充值到卡，全球消费。卡产品与 BIN卡产品决定 BIN、币种、形态与限额硬顶。清单是我方按商户授权给的。开卡申请 → 审核 → 开卡。实体卡多绑卡与激活两步，且激活不可逆。充值到卡与卡内转出充值到卡是两段异步 —— 下单成功不等于钱到卡了。消费管控限额、商户/MCC 名单、账单地址 —— 三种管控，白名单与黑名单不能就地互改。冻结、挂失与销卡冻结与解冻是**两个**过渡态；销卡不可逆，剩余余额由 `POST /close` 清退。查看卡密归属校验通过后明文返回卡号、CVV、有效期。我方只保证自己的库和日志不落这三样。拒付拒付罚金是**你对你会员**的风控手段 —— 我方只看你的整体拒付率。状态机与取值四条状态轴各自独立推进 —— 申请单、卡片、物流、补件。这一页是它们的全集。
Webhook
开卡结果开卡成功、执行失败、持卡人审核通过，或实体卡已可绑定时发送。持卡人通过或可绑定都不代表卡片已可用。3DS 验证码发卡上游把 3DS / OTP 验证码回调给我方时发送。卡状态变化卡片被冻结、解冻、挂失或销卡时发送。到卡入账充值到卡的钱**真的到卡了**那一刻发送 —— 不是下单成功那一刻。卡内转出到账卡内资金退回会员钱包、账本已结清那一刻发送。卡交易更新交易回调、自动巡检或查询补录处理完成后发送，携带交易与卡片的公开 ID 及实际状态。商户资金水位资金低水位提醒、充值提现暂停及补款恢复通知。
API 参考 · 42 个端点
卡产品 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}/recovery
查询失败申请的原因、退款和独立 KYC 审核进度
POST
/v1/cards/applications/{id}/recovery
直接提交修正后的 KYC，独立于旧申请和退款
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
设为默认