跳转到主要内容
POST
修改静态码扩展信息

授权

x-auth-token
string
header
必填

UQPAY 提供的登录 API Token。

请求头

x-client-id
string
必填

UQPAY 生成的 API 客户端 ID

x-on-behalf-of
string<uuid>

要操作的已授权关联子账户。省略或传空值时使用凭证账户。同一码的所有操作应使用相同目标账户。不要将凭证账户 ID 显式作为子账户传入。

路径参数

code_no
string
必填

区分大小写的码牌号,须保留前导零。历史码牌号可能超过新建码的长度限制。

Required string length: 1 - 64
Pattern: ^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$

请求体

application/json
extension
string
必填

用于替换当前值的关联信息。空字符串可清空,不接受 null。 静态码付款通知中的对应字段为 data.payment_method.<method>.static_qrcode_extension;它不是 data.metadata 或商户订单号。见 付款通知字段映射。

Maximum string length: 512

响应

请求已处理,资源状态需单独判断。

code_no
string
必填

码牌号,保留大小写和前导零。 静态码付款通知通过 data.payment_method.<method>.static_qrcode_number_plate 关联此码;同一码可用于多笔付款。见 付款通知字段映射。

status
string
必填

码的创建状态,不是付款状态。INITIATED 表示已开始创建,SUCCEEDED 表示码已创建。

payment_methods
enum<string>[]
必填

此码关联的支付方式。 付款通知的 data.payment_method.type 表示本次交易实际使用的单一支付方式,不回传此数组。

可用选项:
ALIPAY,
WECHAT,
PAYNOW,
UNIONPAY
currency
string
必填

此码收款使用的币种。 付款通知的 data.currency 表示单笔交易的币种。

amount_mode
enum<string>
必填

FIXED 使用指定金额;DYNAMIC 由付款人输入金额。

可用选项:
FIXED,
DYNAMIC
amount
string | null
必填

以主货币单位表示的固定付款金额;DYNAMIC 模式下为 null。响应的小数位数可能与创建请求不同。 对账时读取付款通知中的单笔交易金额 data.amount,不要使用 DYNAMIC 静态码的 null 金额。

store_name
string
必填

此码关联的门店名称。

city
string
必填

此码关联的城市。

extension
string
必填

你的关联信息,不会编码到二维码支付参数中。 静态码付款通知中的对应字段为 data.payment_method.<method>.static_qrcode_extension;它不是 data.metadata 或商户订单号。见 付款通知字段映射。

create_time
string<date-time>
必填

带时区偏移的创建时间。

updated_time
string<date-time> | null
必填

最近更新时间;无更新时间时为 null。