# Create Transaction Request

Create a new transaction request from one of your accounts. This does not perform an on-chain/bank transfer. An admin will process it. You may provide a webhookUrl to receive status updates.

## 📝 Required Fields

- accountId: Your account ID to debit from
- toCBU or toCVU: Recipient bank CBU/CVU (22 digits)
- amount: Positive decimal number
- Optional webhookUrl: URL to receive status updates

## 🔍 Validation Rules

- Account must belong to the authenticated user
- CBU must be a valid 22-digit number
- Optional externalID must be unique per account if provided

Endpoint: POST /transactions
Version: 1.0.0
Security: bearerAuth

## Request fields (application/json):

  - `accountId` (string, required)
    ID of the user's account to send funds from
    Example: "550e8400-e29b-41d4-a716-446655440123"

  - `fromName` (string)
    Name of the transaction sender
    Example: "Juan Pérez"

  - `toName` (string)
    Name of the transaction recipient
    Example: "María García"

  - `fromCBU` (number)
    CBU (bank account number) of the sender
    Example: 170001540000000020000

  - `toCBU` (string)
    Recipient CBU (22 digits). Provide either toCBU or toCVU.
    Example: "1100015400000000000021"

  - `toCVU` (string)
    Recipient CVU (22 digits). Provide either toCBU or toCVU.
    Example: "0000003100012345678901"

  - `amount` (number, required)
    Transaction amount (must be positive)
    Example: 15000.5

  - `fromCUIT` (number)
    CUIT/CUIL of the sender
    Example: 20123456789

  - `toCUIT` (number)
    CUIT/CUIL of the recipient
    Example: 27987654321

  - `concept` (string)
    Transaction concept or description
    Example: "Payment for services"

  - `externalDate` (string)
    Transaction date in your system (ISO 8601 format)
    Example: "2024-06-19T10:30:00Z"

  - `coelsaCode` (string)
    Coelsa transaction code
    Example: "COELSA123456"

  - `data` (object)
    Additional JSON data for the transaction
    Example: {"reference":"REF-001","category":"services","metadata":{"source":"mobile_app","version":"1.2.3"}}

  - `webhookUrl` (string)
    Optional webhook URL to receive status updates for this request
    Example: "https://client.example.com/webhooks/transaction-request"

## Response 201 fields (application/json):

  - `id` (string)
    Internal transaction request ID
    Example: "789e0123-e89b-12d3-a456-426614174999"

  - `externalID` (string)
    Example: "REQ-2024-001234"

  - `createdAt` (string)
    Example: "2024-06-19T10:30:00Z"

  - `status` (string)
    Enum: "PENDING", "PROCESSING", "DONE", "ERROR"

## Response 400 fields (application/json):

  - `success` (boolean)

  - `error` (string)
    Example: "Invalid request"

  - `message` (string)
    Example: "The provided data is invalid"

  - `details` (object)
    Additional error details
    Example: {"field":"amount","code":"INVALID_VALUE"}

## Response 401 fields (application/json):

  - `success` (boolean)

  - `error` (string)
    Example: "Invalid request"

  - `message` (string)
    Example: "The provided data is invalid"

  - `details` (object)
    Additional error details
    Example: {"field":"amount","code":"INVALID_VALUE"}

## Response 500 fields (application/json):

  - `success` (boolean)

  - `error` (string)
    Example: "Invalid request"

  - `message` (string)
    Example: "The provided data is invalid"

  - `details` (object)
    Additional error details
    Example: {"field":"amount","code":"INVALID_VALUE"}


## Response 404 fields