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

# 刷新钱包二维码

> Refresh the wallet QR code for an existing order. Currently only supports CASHAPP wallet payments.



## OpenAPI

````yaml POST /payment/{orderId}/qrcode/refresh
openapi: 3.1.0
info:
  title: Clink API
  description: >-
    Official API documentation for Clink's payment processing platform. This API
    enables merchants to create and manage payment sessions, handle
    subscriptions, and process transactions.
  version: 1.0.0
servers:
  - url: https://uat-api.clinkbill.com/api/
security:
  - ApiKeyAuth: []
paths:
  /payment/{orderId}/qrcode/refresh:
    post:
      summary: Refresh Wallet QR Code
      description: >-
        Refresh the wallet QR code for an existing order. Currently only
        supports CASHAPP wallet payments.
      operationId: refreshWalletQrcode
      parameters:
        - $ref: '#/components/parameters/TimestampHeader'
        - name: orderId
          in: path
          description: Unique identifier of the order
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Wallet QR code refreshed successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RWalletQrcodeRefreshApiVo'
            '*/*':
              schema:
                $ref: '#/components/schemas/RWalletQrcodeRefreshApiVo'
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                type: string
components:
  parameters:
    TimestampHeader:
      name: X-Timestamp
      in: header
      required: true
      description: >-
        Current timestamp in milliseconds since Unix epoch (required for request
        signing)
      schema:
        type: string
        example: '1783513683000'
  schemas:
    RWalletQrcodeRefreshApiVo:
      type: object
      properties:
        code:
          type: integer
          description: Response status code, 200 when success
          format: int32
          example: 200
        msg:
          type: string
          example: success
          description: Brief description of what happened, 'success' when happy case
        data:
          $ref: '#/components/schemas/WalletQrcodeRefreshApiVo'
      description: Body of the response message
    WalletQrcodeRefreshApiVo:
      type: object
      description: Response data returned after refreshing a wallet QR code.
      properties:
        orderId:
          type: string
          description: Unique identifier of the order whose wallet QR code was refreshed
        action:
          $ref: '#/components/schemas/WalletQrcodeRefreshAction'
          description: >-
            Refreshed wallet QR code action. Currently only CASHAPP is
            supported.
    WalletQrcodeRefreshAction:
      type: object
      description: Wallet QR code refresh action. Currently only CASHAPP is supported.
      properties:
        redirectUrl:
          type: string
          description: >-
            Redirect URL that the client should open or navigate to for the next
            payment step.
        method:
          type: string
          description: HTTP method used to perform the next action.
          enum:
            - GET
            - POST
        type:
          type: string
          description: >-
            Payment method or action type. Currently only CASHAPP is supported
            for wallet QR code refresh.
          enum:
            - CASHAPP
          example: CASHAPP
        walletHandleRedirectOrDisplayQrCode:
          $ref: '#/components/schemas/WalletHandleRedirectOrDisplayQrCode'
          description: >-
            Wallet-side display or redirect payload used for QR code rendering,
            mobile auth links, hosted instructions, or fallback URLs.
        paymentMethodType:
          type: string
          description: Payment method type associated with this action.
        postData:
          type: object
          description: Form or request parameters to submit when `method` is `POST`.
          additionalProperties:
            type: string
    WalletHandleRedirectOrDisplayQrCode:
      type: object
      description: Wallet response payload for redirect flows or QR code display flows.
      properties:
        imageUrlPng:
          type: string
          description: >-
            PNG QR code image URL. This field may also contain a Base64-encoded
            image string.
        imageUrlSvg:
          type: string
          description: >-
            SVG QR code image URL. This field may also contain a Base64-encoded
            image string.
        imageDataUrl:
          type: string
          description: Base64-encoded QR code image data URL.
        hostedInstructionsUrl:
          type: string
          description: Hosted instruction or guidance URL for H5 redirection flows.
        mobileAuthUrl:
          type: string
          description: Mobile authorization URL or deeplink used by mobile redirect flows.
        fallbackUrl:
          type: string
          description: Fallback HTTPS URL used when app redirection fails.
        packageName:
          type: string
          description: Android package name used by mobile app redirect flows.
        expiresAt:
          type: integer
          format: int64
          description: Expiration time in Unix seconds.
        expiresSecond:
          type: integer
          format: int64
          description: Optional countdown in seconds until expiration.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: >-
        Your secret API key obtained from the Clink dashboard (Developers
        section)

````