# Create payment

Creates a payment for CRYPTO_CRYPTO or FIAT_CRYPTO flows.

Endpoint: POST /v1/payments
Version: 2.0.0
Security: oAuth2

## Header parameters:

  - `Idempotency-Key` (string)
    A unique key to make POST requests idempotent.

## Request fields (application/json):

  - `railType` (string, required)
    Enum: "FIAT_FIAT", "FIAT_CRYPTO", "CRYPTO_FIAT", "CRYPTO_CRYPTO"

  - `amount` (number, required)
    Example: 25.5

  - `currency` (string, required)
    Example: "USDT"

  - `destination` (object, required)

  - `destination.type` (string, required)
    Enum: "handle", "phone", "address"

  - `destination.value` (string, required)
    Example: "@recipient"

  - `network` (string)
    Enum: "ethereum", "polygon", "solana", "bitcoin"

  - `quoteId` (string,null)

  - `metadata` (object)

## Response 201 fields (application/json):

  - `paymentId` (string, required)
    Example: "pay_01JH..."

  - `status` (string, required)
    Enum: "created", "pending", "succeeded", "failed", "cancelled"

  - `createdAt` (string, required)

  - `railType` (string, required)
    Enum: "FIAT_FIAT", "FIAT_CRYPTO", "CRYPTO_FIAT", "CRYPTO_CRYPTO"

  - `amount` (number, required)

  - `currency` (string, required)

  - `destination` (object, required)

  - `destination.type` (string, required)
    Enum: "handle", "phone", "address"

  - `destination.value` (string, required)
    Example: "@recipient"

  - `network` (string)
    Enum: "ethereum", "polygon", "solana", "bitcoin"

  - `quoteId` (string,null)

  - `providerRef` (string,null)

  - `txHash` (string,null)

## Response 400 fields (application/json):

  - `traceId` (string, required)
    Correlation id for troubleshooting
    Example: "trc_01JH8K5P3V9M2K5Q7W6J3Z1A9B"

  - `error` (object, required)

  - `error.code` (string)
    Example: "INVALID_REQUEST"

  - `error.message` (string)
    Example: "Missing required field"

  - `error.details` (object)


## Response 401 fields