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

# Agency Apply Card for User (Deducted from Agency Assets)



## OpenAPI

````yaml /CARDPLUS-API.json post /wallet/api/agency/applyUserCard
openapi: 3.0.3
info:
  description: Wallet API Documentation
  version: '2.0'
  title: Wallet API Documentation
servers:
  - url: http://access-wallet.test.ftrader.pro
    description: Test development server
security: []
tags:
  - name: General
    description: General common APIs
  - name: Address Management
    description: User address CRUD operations
  - name: Agency Management
    description: Agency-related operations including card application and asset management
  - name: Asset Management
    description: User asset list and asset transfer operations
  - name: Card Management
    description: >-
      Card operations including activation, locking, balance, top-up, transfers,
      and queries
  - name: Deposit
    description: Deposit and top-up from user assets to card
  - name: KYT
    description: Know Your Transaction check
  - name: User Management
    description: User registration, KYC, card application, and information queries
paths:
  /wallet/api/agency/applyUserCard:
    post:
      tags:
        - Agency Management
      summary: Agency Apply Card for User (Deducted from Agency Assets)
      operationId: agencyApplyCardUsingPOST
      parameters:
        - name: addressId
          in: query
          description: Address ID, required if delivery is needed
          required: false
          schema:
            type: integer
            format: int64
        - name: agencyCode
          in: query
          description: Agency code
          required: true
          schema:
            type: string
        - name: appId
          in: query
          description: App identifier
          required: true
          schema:
            type: string
        - name: appUserId
          in: query
          description: App user ID
          required: true
          schema:
            type: string
        - name: assetId
          in: query
          description: Payment asset ID
          required: false
          schema:
            type: integer
            format: int64
        - name: cardSuffix
          in: query
          description: Card number the user already owns
          required: false
          schema:
            type: string
        - name: categoryId
          in: query
          description: Credit card category ID
          required: true
          schema:
            type: integer
            format: int64
        - name: clientCardPhoto
          in: query
          description: URL of the card image uploaded by the user
          required: false
          schema:
            type: string
        - name: embossedName
          in: query
          description: Embossed name (must be uppercase English only), max 20 characters
          required: true
          schema:
            type: string
        - name: needDelivery
          in: query
          description: Whether delivery is needed; if true, addressId is required
          required: false
          schema:
            type: boolean
        - name: sign
          in: query
          description: Signature
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseApplyCardResponseDTO'
components:
  schemas:
    ResponseApplyCardResponseDTO:
      type: object
      required:
        - code
        - msg
      properties:
        code:
          type: integer
          format: int32
        data:
          $ref: '#/components/schemas/ApplyCardResponseDTO'
        msg:
          type: string
    ApplyCardResponseDTO:
      type: object
      required:
        - channel
        - status
      properties:
        cardAccountStatus:
          type: string
          enum:
            - APPROVED
            - CONFIRM
            - NOT_APPLY
            - PENDING_APPROVE
            - PENDING_REVIEW
            - REJECTED
            - REQUIRE_DOC_UPDATE
        cardId:
          type: integer
          format: int64
        cardNumber:
          type: string
        cardUUID:
          type: string
        channel:
          type: string
          enum:
            - CRYPTO
            - EPAY
            - MORGAN
            - TRUST
            - UTGL
            - YINSHENG
        embossedName:
          type: string
        expiryMonth:
          type: string
        expiryYear:
          type: string
        last4:
          type: string
        msg:
          type: string
        status:
          type: string
          enum:
            - ACTIVE
            - ARRIVED
            - CANCELED
            - DELIVERING
            - DISABLE
            - FAILURE
            - LOCKED
            - PENDING_ACTIVATION
            - PENDING_DELIVERY
            - PENDING_ISSUE
            - SUSPENDED

````