1. 前置必读
ORIXA-API文档
  • 默认模块
    • 前置必读
      • 请求签名算法说明
      • Webhook 签名校验文档
      • 端点响应状态码
      • WebHook通知事件
      • 卡片安全展示(Secure Iframe)
    • 持卡人
      • 修改持卡人
      • 持卡人列表-分页查询
      • 创建持卡人
    • 卡片操作
      • 卡片敏感信息-Iframe版
      • 卡片列表(分页查询)
      • 获取卡产品列表
      • 实体卡绑定
      • 激活实体卡
      • 卡片激活码(回调异常情况下主动获取)
      • 卡片详情
      • 卡片充值
      • 卡片敏感信息(卡片三要素)
      • 设置卡片状态
      • 卡片刷新
      • 设置PIN
      • 卡卡转账
      • 虚拟卡创建
      • 卡Iframe-签发 PAN Token
      • 卡Iframe-获取真实卡片 ID
    • WebHook
      • 获取WebHook信息
      • 设置WebHook
      • 通知记录
    • 模拟测试
      • API请求头模拟
      • 卡片授权交易--仅沙箱环境可用
    • 商户信息
      • 商户可用余额
      • 商户账单
    • 供应链
      • 供应商目录
      • 供应商资质披露
      • 产品类目
      • 产品列表
      • 获取指定产品规格
      • 查询某产品规格库存信息
      • 计算运费
      • 订单记录
      • 取消订单-仅待发货可申请
      • 确认收货
      • 创建订单
      • 获取支持快递列表
    • 全球付
      • 扫码支付
        • 二维码识别
        • 预创建订单
        • 发起支付
        • 订单状态查询
      • 支持国家列表
      • 汇款通道
      • 获取汇款/创建受益人参数说明
      • 创建受益人
      • 受益人列表
      • 获取货币汇率
      • 更新受益人
      • 汇款
      • 汇款订单
    • 钱包服务
      • 支持公链
      • 已创建地址列表
      • 创建地址
  1. 前置必读

卡片安全展示(Secure Iframe)

通过安全 iframe 向持卡人展示卡号、有效期和 CVV。卡片敏感数据只在 ORIXA 托管的 iframe 内获取、解密和渲染,你的页面、App 和服务器都不会接触明文卡片数据。

目录#

概览
对接流程
第一步:服务端接口
第二步:前端接入 SDK
第三步:自定义外观(选填)
参数与事件
错误处理
浏览器与 App 要求
安全要求
最佳实践:自有品牌卡面
常见问题

概览#

特性说明
数据隔离卡号、有效期、CVV 只在 iframe 内渲染;页面、JavaScript、服务器均不会通过 URL、postMessage 或 SDK 收到明文。
一次性展示票PAN Token 签发后 60 秒过期、只能使用一次,并且只能用于签发时指定的卡片。
密钥绑定Token 绑定 iframe 内生成的密钥对(jkt),兑换时需要持钥证明。即使 token 泄露,其他页面也无法使用。
默认遮罩卡片默认遮罩显示;展示 30 秒后、窗口失焦或标签页隐藏时自动恢复遮罩。
端到端加密卡片数据通过 TLS 直接传到 iframe,并使用仅存在于该 iframe 实例内的密钥加密。
本功能需由 ORIXA 为你的代理商账户开通。未开通时签票接口会返回错误,请联系你的客户经理。

对接流程#

持卡人点击「查看卡片详情」
      │
      ▼
① 你的前端 → 你的后端:请求真实卡片 ID
      │          你的后端 → ORIXA:POST /agent/v1/card/pan-card-id
      ▼
② 你的前端:初始化 SDK,createElement('issuingCardSecure', { cardId: pan_card_id, getToken })
      │
      ▼
③ iframe 加载并生成密钥对,SDK 调用 getToken(jkt)
      │
      ▼
④ 你的前端 → 你的后端:携带 jkt 请求签票
      │          你的后端 → ORIXA:POST /agent/v1/card/pan-token
      ▼
⑤ getToken 返回 token,SDK 通过 postMessage 交给 iframe
      │
      ▼
⑥ iframe 兑换 token,解密并以遮罩形式展示卡片
要点:
ORIXA 开放 API 的 AccessKey 和签名只能在你的服务端使用,不能放进网页或 App。
你的后端在转发前,必须先验证当前登录用户是这张卡的持卡人。
签票只在持卡人主动打开卡片详情时进行。不要提前签票,也不要循环签票。

第一步:服务端接口#

两个接口都属于 ORIXA 代理商开放 API,鉴权方式与其他接口相同:请求头携带 X-Access-Key、X-Timestamp、X-Nonce、X-Signature,签名规则见《ORIXA 开放 API 通用说明》。
生产环境地址:https://agent.orixa.tech/agent/v1
请求方式:POST,Content-Type: application/json

1. 获取真实卡片 ID#

POST /agent/v1/card/pan-card-id
SDK 的 cardId 需要使用安全展示专用的卡片 ID(pan_card_id),它与开放 API 其他接口中的 card_id 不同,请通过此接口换取。
请求参数
字段类型必填说明
card_idstring是开放 API 中的卡片 ID(开卡、卡列表接口返回的 card_id)。
{ "card_id": "4eac0b82-247e-4fb0-abd5-ec05a096a96f" }
成功响应
{
  "code": 200,
  "msg": "success",
  "time": 1762140000,
  "data": {
    "card_id": "4eac0b82-247e-4fb0-abd5-ec05a096a96f",
    "pan_card_id": "7242a504-e43d-4b95-b4c8-f9fc5992d02b"
  }
}
字段说明
card_id原样返回的开放 API 卡片 ID。
pan_card_id传给 SDK createElement 的 cardId。
pan_card_id 对同一张卡是固定的,你可以在服务端缓存,避免每次都调用此接口。

2. 签发 PAN Token#

POST /agent/v1/card/pan-token
在 SDK 的 getToken(jkt) 回调中由你的后端调用。
请求参数
字段类型必填说明
card_idstring是开放 API 中的卡片 ID(注意:不是 pan_card_id)。
jktstring是SDK 传给 getToken 的值,由 43 个 base64url 字符组成(A-Z a-z 0-9 _ -)。原样透传,不要修改。
{
  "card_id": "4eac0b82-247e-4fb0-abd5-ec05a096a96f",
  "jkt": "Xo1h7m0Jb3QZqk2y8gS9sL4vN6tR5wE1aD3fG7hJ0kM"
}
成功响应
{
  "code": 200,
  "msg": "success",
  "time": 1762140000,
  "data": {
    "token": "pan_xxxxxxxxxxxxxxxx",
    "expires_in": 60,
    "expires_at": "2026-11-03T11:30:00+08:00"
  }
}
字段说明
tokenPAN 展示票,原样返回给前端 getToken。请视为不透明字符串,不要解析、校验或记录到日志。
expires_in有效期(秒),固定为 60。
expires_at到期时间(含时区)。

错误响应#

开放 API 的错误响应格式统一如下:
{
  "code": "AGENT_BIZ_30002",
  "msg": "卡号不存在",
  "detail": "Card not found",
  "request_id": "req_6727...",
  "timestamp": 1762140000,
  "ip": "1.2.3.4"
}
codemsg说明
AGENT_BIZ_30002卡号不存在card_id 不存在或不属于当前代理商。
AGENT_BIZ_30013卡状态异常卡片未激活或不可用。
AGENT_BIZ_30017System上游服务异常,或账户未开通安全展示功能。
AGENT_SYS_50003CardId Empty / Jkt Empty / Jkt Format error参数缺失或 jkt 格式不正确。
AGENT_AUTH_*—鉴权失败,见《ORIXA 开放 API 通用说明》。

第二步:前端接入 SDK#

安装#

前端使用嵌入式 SDK 的 npm 包(包名为固定标识,无需关注):
在页面准备一个空容器:

快速开始#

SDK 会自动完成:加载 iframe、密钥握手、调用 getToken、通过 postMessage 传票、校验消息来源、根据卡片尺寸调整高度。

Vue 3 示例#

<template>
  <div class="card-stage">
    <div ref="cardRef" class="secure-card"></div>
  </div>
</template>

<script setup>
import { ref, onMounted, onBeforeUnmount } from 'vue'
import { init, createElement } from '@uqpay/embedded-sdk'

const props = defineProps({ cardId: String, panCardId: String })
const cardRef = ref(null)
let card = null

onMounted(async () => {
  await init({ env: 'production' })
  card = await createElement('issuingCardSecure', {
    cardId: props.panCardId,
    lang: 'zh-CN',
    getToken: async (jkt) => {
      const res = await fetch('/your-api/card/pan-token', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ cardId: props.cardId, jkt }),
      })
      if (!res.ok) throw new Error('Token request failed')
      return (await res.json()).token
    },
  })
  card.on('error', (e) => console.warn(e.code))
  card.mount(cardRef.value)
})

onBeforeUnmount(() => card?.destroy())
</script>

React 示例#

import { useEffect, useRef } from 'react';
import { init, createElement } from '@uqpay/embedded-sdk';

export function SecureCard({ cardId, panCardId }) {
  const ref = useRef(null);

  useEffect(() => {
    let card;
    let cancelled = false;
    (async () => {
      await init({ env: 'production' });
      const el = await createElement('issuingCardSecure', {
        cardId: panCardId,
        lang: 'zh-CN',
        getToken: async (jkt) => {
          const res = await fetch('/your-api/card/pan-token', {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({ cardId, jkt }),
          });
          if (!res.ok) throw new Error('Token request failed');
          return (await res.json()).token;
        },
      });
      if (cancelled) return el.destroy();
      card = el;
      card.mount(ref.current);
    })();
    return () => { cancelled = true; card?.destroy(); };
  }, [cardId, panCardId]);

  return <div ref={ref} />;
}

框架接入注意事项#

在容器已渲染到页面后再调用 mount(Vue 用 onMounted / nextTick,弹窗类组件要等弹窗打开后)。
组件卸载或弹窗关闭时调用 card.destroy(),清理 iframe 和事件监听。
SDK 加载是异步的;如果加载完成前用户已经关闭了弹窗,应直接 destroy() 新创建的实例,不要再挂载。
不要在每次组件渲染时签票;每次重新打开卡片详情都会自动获取新票。

SDK 选项#

选项类型说明
cardIdstring必填。pan-card-id 接口返回的 pan_card_id。
getToken(jkt) => Promise<string>必填。接收 jkt,返回后端签发的 token。
langstring显示语言:en(默认)、zh / zh-CN(简体)、zh-TW(繁体)。
stylesobject自定义样式对象,见自定义外观。SDK 自动编码,无需 encodeURIComponent。
appearanceobject外观配置,支持 mode 和 variables。
showDataboolean加载后直接展示敏感数据,仅用于完全可信的页面。默认 false。
cardholderNameboolean在卡面上显示持卡人姓名。默认 false。
layout'card' | 'list'card(SDK 默认)为银行卡卡面;list 为每个字段一行的列表样式。
heightnumber | stringiframe 初始高度,例如 400 或 '100%'。
autoResizeboolean跟随卡片内容自动调整 iframe 高度。
titlestringiframe 的 title(无障碍)。
iframeClassNamestring给 iframe 添加 class,便于外层样式控制。

实例方法#

方法说明
mount(target)把 iframe 挂到容器(元素 ID 或 DOM 元素)。
unmount()移除 iframe,实例仍可再次 mount(会创建新的 iframe 并重新签票)。
destroy()移除 iframe 并清除所有监听,实例不可再用。
on(event, handler) / once(event, handler)订阅事件,返回取消订阅函数。

不使用 SDK(原生 iframe + postMessage)#

如果你的页面无法使用 npm 包,也可以手动嵌入 iframe 并完成密钥握手。{EMBEDDED_HOST} 为安全展示服务域名,请向 ORIXA 获取。
自定义样式在原生方式下通过 URL 参数 styles= 传入(URL 编码后的 JSON),见URL 参数。

第三步:自定义外观(选填)#

通过 styles 传入"选择器 → 属性"对象(SDK 直接传对象;原生 iframe 传 URL 编码后的 JSON)。只接受下表中的选择器和属性,每个值都会校验,其余内容会被静默丢弃。 选择器名称(.uq-*)为固定标识,请原样使用。

选择器与属性#

选择器元素可用属性
.uq-card-number卡号color, font-size, font-family, font-weight, text-align
.uq-card-expiry有效期color, font-size, font-family, font-weight
.uq-card-cvvCVVcolor, font-size, font-family, font-weight
.uq-card-cardholder持卡人姓名(仅 cardholderName: true 时显示)color, font-size, font-family, font-weight
.uq-card-container卡片容器background-color, background-image(仅 none 或由颜色停靠点组成的一个 linear-gradient(...),禁止 url()), padding, border, border-radius, width, height, min-height, max-width, min-width
.uq-card-label行内 有效期 / CVV 标签color, font-size, white-space
.uq-card-row字段行(姓名、卡号、有效期、CVV)padding, padding-top, padding-bottom, margin, margin-top, margin-bottom, display, justify-content, align-items, flex-direction, gap
.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-copy-tip.uq-card-tooltip 的兼容别名同上
.uq-page-backgroundiframe 页面背景(默认透明)background-color
.uq-card-brand右下角卡组织标志(Visa / Mastercard)color, display
.uq-card-art字段后方的默认图案层(水印与非接触标志)color, opacity, display

支持的值#

属性类别支持的值
颜色(color, background-color)#rgb, #rgba, #rrggbb, #rrggbbaa;数字分量的 rgb() / rgba() / hsl() / hsla();颜色名称;transparent, currentColor, inherit
长度(font-size, padding*, margin*, gap, width, height, min-*, max-*, letter-spacing)带 px, em, rem, %, vh, vw, vmin, vmax, pt, ch, ex 单位的数字,或 0;padding / margin 最多四个值,gap 最多两个;margin 可为负数或 auto;宽度类还支持 auto, none, max-content, min-content, fit-content;font-size 还支持 xx-small ~ xxx-large、smaller、larger
font-family字母、数字、空格、逗号、引号及连字符,例如 "Courier New", monospace
font-weight100–900, normal, bold, bolder, lighter
border最多三个部分:宽度(长度或 thin / medium / thick)、样式(none, solid, dashed, dotted, double, groove, ridge, inset, outset, hidden)、颜色
border-radius最多四个长度;可再加 / 和最多四个长度定义椭圆圆角
关键字display: block, inline, inline-block, flex, inline-flex, grid, inline-grid, none, contents · justify-content: flex-start, flex-end, center, space-between, space-around, space-evenly, start, end, left, right, normal, stretch · align-items: flex-start, flex-end, center, baseline, stretch, start, end, normal, self-start, self-end · flex-direction: row, row-reverse, column, column-reverse · text-align: left, right, center, justify, start, end · white-space: normal, nowrap, pre, pre-wrap, pre-line, break-spaces · 所有关键字属性还支持 inherit, initial, unset

会被拒绝的内容#

无论什么属性,以下内容都会被拒绝:
url(、expression(、calc()、var()、!important
@、;、{、}、<、>、反斜杠、注释、控制字符
超过 200 字符的值、超过 32 个选择器、单个选择器超过 32 个属性、超过 8 KB 的 styles JSON
常见踩坑:line-height、letter-spacing(除长度类外)、box-shadow、opacity(.uq-card-art 以外)都不在白名单内,写了也不会生效。

默认样式#

宽 480px 的卡片、16px 圆角、1px #e5e7eb 边框和柔和阴影;标签颜色 #374151,字段值为 #111827 等宽字体,页面背景透明。

示例:深色卡面#

示例:渐变卡面#

原生 iframe 传入样式#


参数与事件#

iframe URL 参数#

使用 SDK 时由 SDK 自动生成,以下仅供原生 iframe 接入参考。
参数类型必填说明
cardIdstring是pan_card_id,必须与签票时的卡片一致。
parent_originstring强烈建议你的页面来源,例如 https://app.example.com。iframe 只接收该来源发来的 uq:token,也只向该来源发送事件。
layoutstring否card:银行卡卡面;list:字段列表(不传时为 list)。
langstring否en(默认)、zh / zh-CN、zh-TW;其他值回退为 en。
stylesstring否URL 编码的样式 JSON。
show_databoolean否true 表示加载后直接展示数据,仅识别字面值 true。自动遮罩仍然生效。
cardholder_nameboolean否true 显示持卡人姓名行。

iframe 元素要求#

设置 sandbox 时必须同时包含 allow-scripts 和 allow-same-origin,不需要其他权限。
allow="clipboard-write" 让复制按钮使用现代剪贴板 API;不设置时回退到旧式复制。
iframe 至少 400px 高,或跟随 uq:resize 调整(SDK 用 autoResize: true 自动处理)。

SDK 事件#

事件数据触发时机
ready—iframe 已就绪。
jkt{ jkt }iframe 已生成密钥对(SDK 会自动调用 getToken,一般无需处理)。
rendered—卡片数据已解密并渲染(默认遮罩状态)。适合在此关闭 loading。
masked{ reason }数据恢复遮罩,reason:user / timeout / blur / hidden / unload。
resize{ width, height }卡片尺寸变化。
error{ code, message }终止性错误,见错误处理。
message原始消息所有原始 uq:* 消息,仅用于调试。

原始消息协议(不使用 SDK 时)#

iframe → 你的页面
type数据触发时机
uq:ready—参数已解析,页面就绪。
uq:jktjkt: string(43 字符)已生成密钥对,等待你回传 uq:token。
uq:rendered—卡片已渲染。
uq:maskedreason数据恢复遮罩。
uq:errorcode: string终止性错误。
uq:resizewidth, height(CSS px)尺寸变化,用于调整 iframe 高度。
iframe-loaded / card-rendered—旧事件,card-rendered 不代表数据已显示,请以 uq:rendered 为准。
你的页面 → iframe
type数据规则
uq:tokentoken: string只接受第一条有效消息;targetOrigin 必须是 iframe 所在域名,禁止 '*'。
事件顺序:uq:ready → uq:resize → uq:jkt → 你发送 uq:token → uq:rendered → … uq:masked …

展示行为#

默认遮罩:卡号显示前 8 位和后 4 位(1234 5678 •••• 3456),有效期 ••/••,CVV •••,姓名 ••••。
展示:点击卡号行的眼睛图标(或任一遮罩值)同时展示全部字段。
自动遮罩:展示 30 秒后、iframe 失焦或标签页隐藏时自动遮罩,时长不可延长,持卡人可再次点击展示。
复制:展示状态下每个值旁有复制按钮(卡号不含空格,有效期为 MM/YY)。
尺寸:卡面保持标准银行卡比例(85.6 × 54 mm,约 1.586 : 1),在 iframe 内等比缩放并居中。
语言:lang 控制标签、按钮、提示与错误文案的语言;遮罩格式固定不可修改。

错误处理#

页面无法展示卡片时,iframe 内会显示简短的本地化提示,同时触发 error 事件。错误会终止当前实例,重试时需 destroy() 后重新创建(会重新签票)。
code原因处理方式
TOKEN_FETCH_FAILED / NO_TOKENgetToken 抛错或返回空值(例如你的后端签票失败)。在页面提示用户,检查后端日志中开放 API 返回的错误码。
INVALID_TOKENToken 已过期、已使用、属于其他卡片,或密钥证明不匹配。关闭后重新打开卡片详情。
INVALID_JKT / JKT_REQUIREDjkt 被修改或未传。jkt 必须原样透传。
SECURE_IFRAME_DISABLED账户未开通安全展示。联系 ORIXA 客户经理。
RATE_LIMITED签票或兑换次数过多。稍后重试,不要循环挂载。
BOT_CHECK_FAILED浏览器未通过自动化流量检测。让用户重新加载;检查 https://challenges.cloudflare.com 是否可访问(企业代理、广告拦截、受限 WebView)。
UNSUPPORTED_BROWSER缺少 WebCrypto 等能力,最常见原因是父页面使用了 http://。使用 HTTPS(开发时可用 localhost)。
MISSING_PARAMScardId 缺失或格式错误。检查是否传入了 pan_card_id。
NETWORK_ERROR兑换请求未发出(离线、代理、扩展拦截)。检查网络后重新打开。
DECRYPT_FAILED响应在传输中被篡改或损坏。重新打开;持续出现请联系 ORIXA。
UNKNOWN 等其他其他服务端错误。重新打开;持续出现请携带错误码和时间联系 ORIXA。

浏览器与 App 要求#

支持 Chrome 63+、Safari 11.1+ / iOS 11.3+、Firefox 60+、Edge 79+、Samsung Internet 8+,以及基于这些内核的 WebView。
必须使用 HTTPS:iframe 依赖 WebCrypto,浏览器只在安全上下文中开放;所有祖先页面都必须是 HTTPS(开发可用 localhost)。
必须启用 JavaScript,并允许加载 https://challenges.cloudflare.com(自动化流量检测)。
App 内使用:支持 iOS WKWebView(iOS 11.3+)和 Android System WebView 63+。
承载页面必须以 HTTPS 地址加载,不能用 file:// 本地页面,否则无法使用 WebCrypto。
不要拦截、改写或代理 iframe 的请求,也不要拦截 challenges.cloudflare.com。
不支持通过 iOS / Android / Flutter / React Native 的原生网络请求直接读取卡片数据。
Content Security Policy:如果页面配置了 CSP,请把安全展示服务域名(向 ORIXA 获取)加入 frame-src、script-src、connect-src。SDK 即使通过 npm 安装,也需要从该域名加载元素代码。

安全要求#

AccessKey 只能在服务端使用。浏览器调用你的后端,后端校验用户会话和卡片归属后再调用 ORIXA 开放 API。
不要记录 token:包括服务端日志、埋点、错误监控、会话回放、浏览器控制台和存储的 URL。
不要存储 token:打开卡片详情时签发,用完即弃。
为签票接口限流:建议同一用户、同一张卡每分钟不超过 5 次。
建议二次验证:打开卡片详情前先要求用户输入短信 / 邮箱验证码或支付密码,验证通过后才允许签票。
校验消息来源(原生接入时):event.origin 用 === 精确比较,禁止 indexOf / endsWith / 正则;同时校验 event.source === iframe.contentWindow。
showData: true 只用于完全由你控制的页面,页面中不能有未经审查的第三方脚本。
不要录制 iframe:会话回放、录屏、行为分析 SDK 不得采集 iframe 区域。
只能在持卡人的浏览器或 App WebView 中使用:从服务器、脚本、无头浏览器加载组件以提取卡片数据属于禁止行为,会被检测并拦截。

最佳实践:自有品牌卡面#

样式白名单禁止 url(),无法在 iframe 内放图片。如果想使用自己的卡面背景图和品牌 Logo,推荐以下做法:
1.
外层容器用你自己的背景图绘制卡面,比例固定为 1.586 : 1。
2.
通过 styles 隐藏默认图案层,并把 iframe 内的卡片容器和页面背景设为透明,文字改为适合深色卡面的颜色。
3.
iframe 绝对定位叠在外层卡面上。iframe 页面四周自带约 14px 留白,卡片在剩余区域内等比居中;把 iframe 向外扩出这圈留白,并让外层 overflow: hidden,即可让卡片与背景图重合。
背景图设计建议
比例 1.586 : 1,建议 1200 × 757 px,JPG,100 KB 左右。
直角出图,圆角由 CSS 裁切;不要自带阴影。
不要在图中放卡号、有效期、"Valid Thru"、VISA / Mastercard 标志、芯片——这些由 iframe 渲染。
左下半区(姓名、卡号、有效期 / CVV)和右下角(卡组织标志)保持深色、干净,保证白色文字清晰;品牌 Logo 和装饰图形放在上半部分或右上角。

常见问题#

Q:pan_card_id 和 card_id 有什么区别?
card_id 是开放 API 中的卡片 ID,用于所有开放 API 接口(包括 pan-token);pan_card_id 只用于前端 SDK 的 cardId。
Q:页面提示 "Browser not supported",但浏览器很新。
通常是父页面使用了 http://(localhost 除外),或 App 用 file:// 加载页面,导致无法使用 WebCrypto。其他原因包括 iframe sandbox 缺少 allow-same-origin,或 WebView 内核过旧。
Q:Token 在 iframe 加载前就过期了?
密钥绑定流程在 iframe 请求时才签票,一般不会出现。如果出现 INVALID_TOKEN,关闭后重新打开即可(会重新签票)。
Q:同一页面能展示多张卡吗?
可以。每张卡分别 createElement 并 mount,各自独立签票、独立事件。
Q:能延长 30 秒展示时间或关闭自动遮罩吗?
不能。持卡人可以再次点击展示;showData 只控制初始状态。
Q:能修改标签文字、遮罩格式吗?
标签由 lang 决定,遮罩格式固定。字体、字号、颜色可通过 styles 白名单调整。
Q:样式写了不生效?
检查选择器和属性是否在白名单内,值是否包含被拒绝的内容(如 url()、calc()、!important)。常见不生效的属性有 line-height、box-shadow。
Q:卡片背景想放自己的图片和 Logo?
iframe 内禁止 url(),请参考自有品牌卡面,在外层容器放背景图。
Q:能用同样方式展示或修改 PIN 吗?
不能。安全展示不提供 PIN 展示或修改,PIN 重置请使用开放 API POST /agent/v1/card/set-pin。
Q:iframe 会使用 Cookie 或本地存储吗?
页面本身不使用。内部的自动化流量检测可能使用自身存储;屏蔽第三方 Cookie 不影响展示。
上一页
WebHook通知事件
下一页
修改持卡人
Built with