> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询静态码可用选项

> 查询目标账户配置、已启用的支付方式和支持的币种。参阅[静态二维码指南](/zh/global-acquiring/v1.6/guide/static-qr-codes)。



## OpenAPI

````yaml /zh/global-acquiring/v1.6/payment.yaml get /v2/payment/static_qrs/options
openapi: 3.0.2
info:
  title: Payment API
  version: 0.0.1
  x-source-en-commit: 8d93105
  x-source-en-path: global-acquiring/v1.6/payment.yaml
  description: >
    UQPAY Payment API 让你接受付款、管理交易，并处理退款与出款。


    ## 功能概览

    - 使用卡、数字钱包和本地支付方式创建并确认 PaymentIntent

    - 处理全额和部分退款

    - 创建出款与银行账户记录

    - 查询 PaymentAttempt、余额与交易历史


    ## 身份认证

    所有请求都需要携带有效的鉴权 Token，Token 通过 [Access
    Token](/zh/account-center/v1.6/api-reference/access-token) 接口获取。请在
    `x-auth-token` 请求头中携带该 Token。


    ## 幂等性

    POST 请求支持 `x-idempotency-key` 请求头，可在不重复创建资源的前提下安全重试。
  contact:
    name: UQPAY Support Team
    url: https://www.uqpay.com/support
    email: support@uqpay.com
  license:
    name: Proprietary
    url: https://www.uqpay.com/legal/api-terms
  termsOfService: https://www.uqpay.com/legal/terms
servers:
  - url: https://api-sandbox.uqpaytech.com/api
    description: 沙盒环境基础 URL。
  - url: https://api.uqpay.com/api
    description: 生产环境基础 URL。
security:
  - XAuthToken: []
tags:
  - name: Payment Intents
    description: >-
      PaymentIntent 引导你完成向客户收款的整个流程。建议你的系统中每个订单或客户会话只创建一个 PaymentIntent。之后可以引用该
      PaymentIntent，查看某次会话的 PaymentAttempt 历史。
  - name: Payment Attempts
    description: >-
      每当客户使用所选 PaymentMethod 付款时，都会创建一个 PaymentAttempt 对象。通过该 API
      可以了解客户是如何为订单付款的。
  - name: Payment Refunds
    description: >
      你可以创建多笔部分退款，直至累计达到原交易金额。每笔退款都会生成唯一记录，并自动校验可用余额。

      PaymentIntent 引导你完成向客户收款的整个流程。建议你的系统中每个订单或客户会话只创建一个 PaymentIntent。之后可以引用该
      PaymentIntent，查看某次会话的 PaymentAttempt 历史。
  - name: Payment Balances
    description: |
      支付余额管理让你查询不同币种的账户余额。你可以查询单个币种的余额，也可以分页查询所有币种的余额。
  - name: Payment Payouts
    description: |
      出款管理让你创建和管理用于资金划转的出款单。你可以创建出款、查询单笔出款，也可以分页并按条件筛选列出所有出款。
  - name: Terminal Management
    description: 用于 POS 设备注册和密钥管理的终端管理 API。
  - name: Bank Accounts
    description: |
      用于结算账户的银行账户管理 API。可创建、更新、查询和列出用于接收结算款项的银行账户。
  - name: Static QR Codes
    description: 创建、查询和管理可重复使用的收款二维码。
paths:
  /v2/payment/static_qrs/options:
    get:
      tags:
        - Static QR Codes
      summary: 查询静态码可用选项
      description: >-
        查询目标账户配置、已启用的支付方式和支持的币种。参阅[静态二维码指南](/zh/global-acquiring/v1.6/guide/static-qr-codes)。
      operationId: get-static-qr-options
      parameters:
        - $ref: '#/components/parameters/XClientID'
        - $ref: '#/components/parameters/StaticQRTarget'
      responses:
        '200':
          description: 请求已处理，资源状态需单独判断。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StaticQROptions'
              examples:
                sandbox:
                  summary: 查询静态码可用选项
                  value:
                    eligible: false
                    ineligible_reasons:
                      - WECHAT_SGQR_NOT_CONFIGURED
                      - PAYNOW_CHANNEL_NOT_CONFIGURED
                    payment_methods:
                      - ALIPAY
                      - WECHAT
                      - PAYNOW
                      - UNIONPAY
                    currencies:
                      - SGD
        '400':
          description: 字段无效或静态码配置要求未满足。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StaticQRError'
        default:
          description: 其他错误（包括鉴权失败）可能使用通用 API 错误响应。
components:
  parameters:
    XClientID:
      in: header
      name: x-client-id
      schema:
        type: string
      required: true
      description: UQPAY 生成的 API 客户端 ID
      example: Up1HIsjiETgON9PMGPXLy7
    StaticQRTarget:
      name: x-on-behalf-of
      in: header
      required: false
      description: 要操作的已授权关联子账户。省略或传空值时使用凭证账户。同一码的所有操作应使用相同目标账户。不要将凭证账户 ID 显式作为子账户传入。
      schema:
        type: string
        format: uuid
  schemas:
    StaticQROptions:
      type: object
      required:
        - eligible
        - ineligible_reasons
        - payment_methods
        - currencies
      properties:
        eligible:
          type: boolean
          description: 账户是否满足所检查的静态码配置要求。结合计划使用的支付方式查看 ineligible_reasons。
        ineligible_reasons:
          type: array
          description: 尚未满足的账户或支付方式配置要求。需要配置协助时联系 UQPAY 支持团队。
          items:
            type: string
        payment_methods:
          type: array
          description: 已启用的支付方式。列在此处不代表所有渠道配置要求均已满足。
          items:
            type: string
            enum:
              - ALIPAY
              - WECHAT
              - PAYNOW
              - UNIONPAY
        currencies:
          type: array
          description: 创建码可用的币种。
          items:
            type: string
    StaticQRError:
      type: object
      required:
        - code
        - message
        - type
      properties:
        code:
          type: string
          description: 供程序识别的错误码。
        message:
          type: string
          description: 失败原因，以及可用时的修正方法。
        type:
          type: string
          enum:
            - static_qr_error
  securitySchemes:
    XAuthToken:
      type: apiKey
      in: header
      name: x-auth-token
      description: UQPAY 提供的登录 API Token。

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.