# Create user transaction

Create transaction for authenticated user. Sender automatically set to authenticated user. Replaces POST /transaction/auth/transaction

Endpoint: POST /transactions/user
Version: 2.0.2
Security: authUserJWT

## Request fields (application/json):

  - `web3TransactionType` (string, required)
    Transaction type for easier detection and routing
    Enum: "MINT", "TRANSFER", "BURN"

  - `sender` (object)
    Transaction sender (not required for MINT operations)

  - `sender.accountId` (string)
    Account ID (businessId or userId). System will auto-detect account type.
    Example: "user123"

  - `sender.accountType` (string, required)
    Account type
    Enum: "user", "business", "tenant", "system", "external"

  - `sender.accountAddress` (string)
    Direct account address (fallback if account ID not found)
    Example: "0x742d35Cc5dB3dC0F0e8f0b0d2fA0c3fA2ed5D0f8"

  - `recipient` (object)
    Transaction recipient (not required for BURN operations)

  - `token` (object)
    Token identification with multiple resolution strategies. If not provided, defaults to active credit token.

  - `token.tokenDbId` (string)
    Database token UUID - highest priority for resolution
    Example: "uuid-12345-67890"

  - `token.contractAddress` (string)
    Smart contract address on blockchain
    Example: "0x742d35Cc5dB3dC0F0e8f0b0d2fA0c3fA2ed5D0f8"

  - `token.nftTokenId` (string)
    Blockchain NFT token ID (on-chain identifier) - STANDARDIZED FIELD
    Example: "721"

  - `token.chainId` (number)
    Blockchain chain ID - auto-resolved from token if not provided
    Example: 1

  - `amount` (number, required)
    Transaction amount
    Example: 100

## Response 200 fields (application/json):

  - `amount` (number, required)
    Transaction amount

  - `id` (string, required)
    Transaction id

  - `tokenAddress` (string, required)
    Transaction token address

  - `contractTokenId` (object,null, required)
    Transaction token contract id, this is the blockchain contract id of the token

  - `tokenType` (string, required)
    Transaction token type

  - `senderAddress` (string, required)
    Sender address

  - `recipientAddress` (object, required)
    Recipient address

  - `transactionHash` (object, required)
    Transaction hash

  - `type` (string, required)
    Transaction type
    Enum: "MINT", "TRANSFER", "BURN"

  - `triggerProcessType` (string, required)
    Trigger process type
    Enum: "PURCHASE", "SPEND", "TRANSFER", "EARN", "CAMPAIGN_USER_CLAIM", "CAMPAIGN_SYSTEM_CLAIM", "CAMPAIGN_BUSINESS_CLAIM", "REDEMPTION_SPEND", "REDEMPTION_RECEIVE", "MIGRATION", "ADMIN_TRIGGERED"

  - `triggerProcessId` (object, required)
    Trigger process id, this is the id of the entity that triggered the transaction if applicable (e.g. CampaignUserClaim id)

  - `status` (string, required)
    Transaction status
    Enum: "created", "processing", "pending_signature", "broadcasted", "succeeded", "failed"

  - `createdAt` (object, required)
    create date

  - `updatedAt` (object, required)
    update date

  - `tenantId` (string, required)
    Tenant ID for multi-tenant isolation

  - `chainId` (number, required)
    Blockchain chain ID

  - `senderId` (object,null, required)
    Sender entity ID (polymorphic reference)

  - `senderOwnerType` (string,null, required)
    Sender entity type (user, business, system etc.)
    Enum: "user", "business", "tenant", "system", "external"

  - `recipientId` (object,null, required)
    Recipient entity ID (polymorphic reference)

  - `recipientOwnerType` (string,null, required)
    Recipient entity type (user, Business, system, etc.)
    Enum: "user", "business", "tenant", "system", "external"