何时使用一次性卡
一次性卡与普通卡的区别
支持的卡 BIN
一次性卡仅在指定的卡 BIN 上可用。沙盒测试请使用产品 BIN40963608。生产环境请联系 UQPAY 客户经理确认你账户下哪些 BIN 启用了一次性卡功能。
如果你在调用 创建卡片 时，对一个未启用该功能的 BIN 传入 usage_type: ONE_TIME，请求会被拒绝。
创建一次性卡
发起 创建卡片 请求时，在普通卡参数基础上额外传入以下三个字段：示例
PENDING，几秒内会变为 ACTIVE，即可用于这笔单次交易。
注销触发模式
请在创建时选择其中一种模式。卡片创建后无法再切换。ON_AUTH —— 首次授权通过后注销
如果你希望卡片在首次被授权后即不可再用，请选择此模式。一旦有一笔授权请求通过，卡片立即注销。同一张卡后续任何授权请求 —— 包括来自同一商户的 —— 都会被拒绝。
ON_CAPTURE —— 首次清算成功后注销
卡片在首次授权清算（结算）前持续可用。在授权与清算之间的窗口内，卡片会被锁定到首次授权通过的商户：该商户可以对同一张卡发起再次授权（例如调整金额或重试），只要可用余额充足，这些授权都会通过；任何其他商户发起的授权都会被拒绝。
首次清算成功后，卡片自动注销。
判定汇总
为支持卡片绑定（card-on-file）等场景，金额低于 USD 1（或其他币种等值金额）的验证类授权不会计入触发条件，因此不会导致卡片自动注销。
一次性卡不支持的操作
下列接口对一次性卡返回 HTTP 400： 错误响应示例：一次性卡注销后的处理
- 卡片直接转为
CANCELLED状态，不会先经过PRE_CANCEL过渡（与手动注销普通卡的流程不同），且无法再次激活。 - 任何未消费的可用余额会自动释放回你的发卡账户余额。
- 卡片记录会保留，可通过
card_id查询用于对账。 - 已注销的一次性卡仍可接收退款与冲正；退款金额会进入你的发卡账户余额，而不会回到已注销的卡上。
费用与配额
- 开卡数量配额 与普通卡共享。一张一次性卡会从持卡人和机构维度的同一开卡数量上限中各占用一个名额。
常见问题
一次性卡触发注销后还能再使用吗？
一次性卡触发注销后还能再使用吗？
不能。一旦触发注销（或
expiry_at 到期），卡片即永久注销，无法再次激活。ON_CAPTURE 模式下，同一张卡的第二笔授权为什么被拒？
ON_CAPTURE 模式下，同一张卡的第二笔授权为什么被拒？
ON_CAPTURE 模式下，卡片会被锁定到首次授权通过的商户。如果第二笔授权来自其他商户，会被系统按规则拒绝；同一商户的后续授权在首次清算前仍会通过。卡片注销后还能接收退款吗？
卡片注销后还能接收退款吗？
可以。已注销的一次性卡仍可接收退款与冲正，退款金额会进入你的发卡账户余额。