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

# Create crypto payout

> Create a new cryptocurrency payout. The order is created in "Created" state and may require OTP validation before being dispatched.
Only one of amounts.debitedAmount.amount or amounts.receivedAmount.amount can be provided (set the other to 0).



## OpenAPI

````yaml post /api/v1/account/users/{uid}/accounts/{aid}/crypto-payouts
openapi: 3.0.1
info:
  title: RALIO API
  description: Banking as a service API.
  contact:
    name: Tropipay Support
    url: https://help.tropipay.com/contacto/
    email: support@tropipay.com
  version: '1.0'
servers:
  - url: https://sandbox-revo-api.raliopay.com/
security: []
paths:
  /api/v1/account/users/{uid}/accounts/{aid}/crypto-payouts:
    post:
      tags:
        - payouts
      summary: Create crypto payout
      description: >-
        Create a new cryptocurrency payout. The order is created in "Created"
        state and may require OTP validation before being dispatched.

        Only one of amounts.debitedAmount.amount or
        amounts.receivedAmount.amount can be provided (set the other to 0).
      parameters:
        - name: uid
          in: path
          description: User ID
          required: true
          schema:
            type: string
        - name: aid
          in: path
          description: Account ID
          required: true
          schema:
            type: string
      requestBody:
        description: Payout details
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/dto.CreateCryptoPayoutRequest'
        required: true
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dto.CreatePayoutResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/httperror.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/httperror.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/httperror.ErrResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    dto.CreateCryptoPayoutRequest:
      required:
        - amounts
        - ownReference
        - recipient
      type: object
      properties:
        amounts:
          $ref: '#/components/schemas/dto.CryptoPayoutAmounts'
        ownReference:
          type: string
          example: CRYPTO-PAY-2025-001234
        recipient:
          $ref: '#/components/schemas/dto.CryptoPayoutRecipient'
    dto.CreatePayoutResponse:
      type: object
      properties:
        canceledAt:
          type: string
          example: '2025-01-15T10:35:00.000Z'
        counterparty:
          type: string
          description: >-
            Counterparty is the party on the other side of the order, resolved
            per

            operation type: sender/cardholder for incomes, recipient/destination
            for

            expenses. May be empty when not available.
          example: John Doe
        createdAt:
          type: string
          example: '2025-01-15T10:30:00.000Z'
        destination:
          $ref: '#/components/schemas/domain.Money'
        detailUrl:
          type: string
          example: /api/v1/account/orders/e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8a9b
        displayType:
          type: string
          example: Transaction Type
        failedAt:
          type: string
          example: '2025-01-15T10:35:00.000Z'
        fee:
          $ref: '#/components/schemas/domain.Money'
        fx:
          $ref: '#/components/schemas/dto.FXResponse'
        id:
          type: string
          example: e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8a9b
        isOTPRequired:
          type: boolean
          example: true
        origin:
          $ref: '#/components/schemas/domain.Money'
        reference:
          type: string
          example: PAY-2025-001234
        reversedAt:
          type: string
          example: '2025-01-15T10:35:00.000Z'
        settledAt:
          type: string
          example: '2025-01-15T10:35:00.000Z'
        state:
          type: string
          example: PENDING
        type:
          type: string
          example: TRANSACTION_TYPE
        updatedAt:
          type: string
          example: '2025-01-15T10:30:05.000Z'
    httperror.ErrResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/httperror.ErrorData'
    dto.CryptoPayoutAmounts:
      required:
        - debitedAmount
        - receivedAmount
      type: object
      properties:
        debitedAmount:
          $ref: '#/components/schemas/domain.Money'
        receivedAmount:
          $ref: '#/components/schemas/domain.Money'
    dto.CryptoPayoutRecipient:
      required:
        - address
        - network
      type: object
      properties:
        address:
          type: string
          example: '41453196840881978364684601463897081767828327403'
        network:
          type: string
          example: SOLANA
    domain.Money:
      required:
        - currency
      type: object
      properties:
        amount:
          type: integer
          description: 'Amount in cents. Ex: 12345 = 123.45€'
          example: 1000
        currency:
          type: string
          description: USD, EUR, etc.
          example: CURRENCY
          enum:
            - EUR
            - USD
            - MXN
            - CAD
            - BRL
            - COP
            - PEN
            - BOB
            - CLP
            - ARS
            - UYU
            - PYG
            - CNY
            - HKD
            - MYR
            - USDT
            - USDC
            - EURC
            - BTC
            - ETH
    dto.FXResponse:
      type: object
      properties:
        pair:
          type: string
          example: CURRENCY/CURRENCY
        rate:
          type: number
          example: 1.08
        timestamp:
          type: string
          example: '2025-01-15T10:30:00.000Z'
    httperror.ErrorData:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/httperror.ErrorCode'
        details:
          type: array
          items:
            $ref: '#/components/schemas/httperror.ErrorDetails'
        message:
          type: string
        type:
          $ref: '#/components/schemas/httperror.ErrorType'
    httperror.ErrorCode:
      type: string
      enum:
        - INVALID_REQUEST
        - UNAUTHORIZED
        - FORBIDDEN
        - NOT_FOUND
        - INTERNAL_SERVER_ERROR
        - UNKNOWN_ERROR
        - NOT_IMPLEMENTED
        - TOO_MANY_REQUESTS
        - QUOTE_EXPIRED
      x-enum-varnames:
        - InvalidRequestCode
        - UnauthorizedCode
        - ForbiddenCode
        - NotFoundCode
        - InternalServerCode
        - UnknownErrorCode
        - NotImplementedCode
        - TooManyRequestsCode
        - QuoteExpiredCode
    httperror.ErrorDetails:
      type: object
      properties:
        field:
          type: string
        message:
          type: string
    httperror.ErrorType:
      type: string
      enum:
        - VALIDATION_ERROR
        - CONFLICT_ERROR
        - UNPROCESSABLE_ERROR
        - AUTHENTICATION_ERROR
        - AUTHORIZATION_ERROR
        - NOT_FOUND_ERROR
        - INTERNAL_ERROR
        - NOT_IMPLEMENTED_ERROR
        - UNKNOWN_ERROR
        - RATE_LIMIT_ERROR
      x-enum-varnames:
        - ValidationError
        - ConflictError
        - UnprocessableError
        - AuthenticationError
        - AuthorizationError
        - NotFoundError
        - InternalError
        - NotImplementedError
        - UnknownError
        - RateLimitError
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: API Key for accessing management endpoints
      x-mint-auth-type: bearer

````