> ## 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.

# Card-to-Card Balance Transfer



## OpenAPI

````yaml /CARDPLUS-API.json post /wallet/api/card/balance/transfer
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/card/balance/transfer:
    post:
      tags:
        - Card Management
      summary: Card-to-Card Balance Transfer
      operationId: cardBalanceTransferUsingPOST
      parameters:
        - name: agencyCode
          in: query
          description: Agency code
          required: true
          schema:
            type: string
        - name: amount
          in: query
          description: Transfer amount (minimum 2)
          required: true
          schema:
            type: number
        - name: appId
          in: query
          description: App identifier
          required: true
          schema:
            type: string
        - name: fromAppUserEmail
          in: query
          description: Sender app user email
          required: true
          schema:
            type: string
        - name: fromAppUserId
          in: query
          description: Sender app user ID
          required: true
          schema:
            type: string
        - name: fromCardNumber
          in: query
          description: Sender card number
          required: true
          schema:
            type: string
        - name: sign
          in: query
          description: Signature
          required: true
          schema:
            type: string
        - name: timestamp
          in: query
          description: Current millisecond timestamp (must be within 1 minute)
          required: true
          schema:
            type: integer
            format: int64
        - name: toAppUserEmail
          in: query
          description: Receiver app user email
          required: true
          schema:
            type: string
        - name: toCardNumber
          in: query
          description: Receiver card number
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseApiCardBalanceTransferDTO'
components:
  schemas:
    ResponseApiCardBalanceTransferDTO:
      type: object
      required:
        - code
        - msg
      properties:
        code:
          type: integer
          format: int32
        data:
          $ref: '#/components/schemas/ApiCardBalanceTransferDTO'
        msg:
          type: string
    ApiCardBalanceTransferDTO:
      type: object
      properties:
        agencyCode:
          type: string
          description: Agency code
        amount:
          type: number
          description: Amount
        appId:
          type: string
          description: App identifier
        channelCardTransactionId:
          type: string
          description: Channel transaction ID
        currency:
          type: string
          description: Currency
        entryType:
          type: string
          description: Entry type
        fromAppUserEmail:
          type: string
          description: Sender app user email
        fromAppUserId:
          type: string
          description: Sender app user ID
        fromCardNumber:
          type: string
          description: Sender card number
        fromEmbossedName:
          type: string
          description: Sender name
        intent:
          type: string
          description: Transaction intent
        postedAt:
          type: string
          format: date-time
          description: Timestamp
        status:
          type: string
          description: Transaction status
          enum:
            - CREATED
            - FAILURE
            - PENDING
            - REFUNDED
            - SUCCESS
        toAppUserEmail:
          type: string
          description: Receiver app user email
        toAppUserId:
          type: string
          description: Receiver app user ID
        toCardNumber:
          type: string
          description: Receiver card asset ID
        toEmbossedName:
          type: string
          description: Receiver name

````