安全展示卡片
为指定卡片创建一次性 PAN Token，并返回可直接嵌入的 Secure Iframe 地址。持卡人在 iframe 中查看卡号、有效期和 CVV。平台不保存这些字段。链接约 60 秒内有效，且只能打开一次。
POSThttps://uqpay.zytong.cn/openapi/v1/cards/iframe
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
card_id |
string | 是 | 卡片 ID，必须属于当前客户 |
lang |
string | 否 | 显示语言。zh、en 或 zh-TW，默认 zh |
show_data |
boolean | 否 | true 时打开即显示卡号、有效期和 CVV。默认 false，由持卡人点击眼睛或掩码切换。仅建议在受信任页面使用 |
cardholder_name |
boolean | 否 | true 时展示持卡人姓名。取卡片 name_on_card，没有则用持卡人姓和名。默认 false |
styles |
object | 否 | 按 CSS 选择器自定义 iframe 外观。平台会做 URL 编码。选择器见下方表格 |
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
code |
int | 0 成功，-1 失败，-2 处理中或结果未知 |
success |
boolean | 是否成功 |
message |
string | 结果说明。失败时为错误原因 |
data |
object | 业务数据 |
data.card_id |
string | 卡片 ID |
data.iframe_url |
string | 一次性展示地址。约 60 秒内有效，且只能打开一次。地址中的 token 不要另行保存 |
data.expires_in |
int | 有效秒数，通常为 60 |
data.expires_at |
string | 过期时间，ISO 8601。上游未返回时为空 |
如何嵌入
把 data.iframe_url 设为 iframe 的 src。建议高度至少 400，宽度不超过 1280。不要缓存这个地址，也不要写进日志。
环境
平台按当前上游环境选择 iframe 域名。沙盒为 https://embedded-sandbox.uqpaytech.com ，生产为 https://embedded.uqpay.com 。客户直接使用返回的地址。
官方说明
卡面字段、眼睛图标和样式能力与 UQPAY Secure Iframe 一致。 查看 Secure Iframe 集成指南
styles 可用选择器
| 选择器 | 作用 | 常用属性 |
|---|---|---|
.uq-card-number | 卡号 | color、font-size、font-family、font-weight |
.uq-card-expiry | 过期日期 | color、font-size、font-family、font-weight |
.uq-card-cvv | CVV | color、font-size、font-family、font-weight |
.uq-card-cardholder | 持卡人姓名，仅 cardholder_name 为 true 时出现 | color、font-size、font-family、font-weight |
.uq-card-container | 卡片容器 | background-color、padding、border、border-radius、width、height |
.uq-card-row | 一行一个字段 | display、justify-content、align-items、gap |
.uq-card-label | 字段标签 | color、font-size |
.uq-card-button | 复制按钮 | color、background-color、border、border-radius、padding |
.uq-card-button:hover | 复制按钮悬停 | color、background-color |
.uq-card-button:active | 复制按钮按下 | color、background-color |
.uq-card-tooltip | 复制成功提示 | color、background-color、font-size、border-radius |
.uq-page-background | iframe 页面背景，默认透明 | background-color |