curl --request POST \
--url https://api-sandbox.uqpaytech.com/api/v2/payment/static_qrs \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <api-key>' \
--header 'x-client-id: <x-client-id>' \
--header 'x-idempotency-key: <x-idempotency-key>' \
--data '
{
"payment_methods": [
"ALIPAY"
],
"currency": "SGD",
"amount_mode": "DYNAMIC",
"code_no": "D5610f5e1",
"store_name": "Docs Test",
"extension": "no payment test"
}
'{
"status": "INITIATED",
"code_no": "D5610f5e1",
"create_time": "2026-10-28T10:18:44+08:00",
"payment_methods": [
"ALIPAY"
],
"currency": "SGD",
"amount_mode": "DYNAMIC",
"amount": null,
"store_name": "Docs Test",
"city": "Singapore",
"extension": "no payment test"
}创建静态二维码
创建可重复使用的收款码。HTTP 200 且状态为 INITIATED 表示已开始创建，不代表码已就绪或付款成功。使用返回的 code_no 查询码及其详情。响应不明确时，以相同幂等键和请求重试。
curl --request POST \
--url https://api-sandbox.uqpaytech.com/api/v2/payment/static_qrs \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <api-key>' \
--header 'x-client-id: <x-client-id>' \
--header 'x-idempotency-key: <x-idempotency-key>' \
--data '
{
"payment_methods": [
"ALIPAY"
],
"currency": "SGD",
"amount_mode": "DYNAMIC",
"code_no": "D5610f5e1",
"store_name": "Docs Test",
"extension": "no payment test"
}
'{
"status": "INITIATED",
"code_no": "D5610f5e1",
"create_time": "2026-10-28T10:18:44+08:00",
"payment_methods": [
"ALIPAY"
],
"currency": "SGD",
"amount_mode": "DYNAMIC",
"amount": null,
"store_name": "Docs Test",
"city": "Singapore",
"extension": "no payment test"
}授权
UQPAY 提供的登录 API Token。
请求头
UQPAY 生成的 API 客户端 ID
要操作的已授权关联子账户。省略或传空值时使用凭证账户。同一码的所有操作应使用相同目标账户。不要将凭证账户 ID 显式作为子账户传入。
每次新建使用新的键。响应不明确时，以相同键重试相同请求。同一键用于不同请求参数会返回冲突。此请求头只能发送一次。
请求体
选择目标账户已启用的支付方式，通过可用选项接口检查账户与渠道配置。 付款通知的 data.payment_method.type 表示本次交易实际使用的单一支付方式，不回传此数组。
1 - 4 elementsALIPAY, WECHAT, PAYNOW, UNIONPAY 使用可用选项接口返回的大写币种。 付款通知的 data.currency 表示单笔交易的币种。
FIXED 使用指定金额；DYNAMIC 由付款人输入金额。
FIXED, DYNAMIC FIXED 时必填：以主货币单位表示的正数十进制字符串，必须恰好保留两位小数。DYNAMIC 时必须完全省略，不接受 null、空字符串或零。 对账时读取付款通知中的单笔交易金额 data.amount，不要使用 DYNAMIC 静态码的 null 金额。
^[0-9]+\.[0-9]{2}$最多 25 字节。省略或传空字符串时使用目标账户名称，不接受 null。
响应
请求已处理，资源状态需单独判断。
码的创建状态，不是付款状态。INITIATED 表示已开始创建，SUCCEEDED 表示码已创建。
此码关联的支付方式。 付款通知的 data.payment_method.type 表示本次交易实际使用的单一支付方式，不回传此数组。
ALIPAY, WECHAT, PAYNOW, UNIONPAY 此码收款使用的币种。 付款通知的 data.currency 表示单笔交易的币种。
FIXED 使用指定金额；DYNAMIC 由付款人输入金额。
FIXED, DYNAMIC 以主货币单位表示的固定付款金额；DYNAMIC 模式下为 null。响应的小数位数可能与创建请求不同。 对账时读取付款通知中的单笔交易金额 data.amount，不要使用 DYNAMIC 静态码的 null 金额。
此码关联的门店名称。
此码关联的城市。
带时区偏移的创建时间。