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

# Initiate crypto collection

> Initiate a crypto collection to fund a wallet using cryptocurrency. Required scope: `collection:crypto:create`.



## OpenAPI

````yaml /api-reference/collection/initiate-crypto-openapi.json post /api/external/collection/crypto
openapi: 3.1.0
info:
  title: Blaaiz Platform API - Initiate Crypto Collection
  version: 1.0.0
  description: Initiate a crypto collection to fund a wallet using cryptocurrency.
servers:
  - url: https://api-prod.blaaiz.com
  - url: https://api-dev.blaaiz.com
security: []
tags:
  - name: Collection
paths:
  /api/external/collection/crypto:
    post:
      tags:
        - Collection
      summary: Initiate crypto collection
      description: >-
        Initiate a crypto collection to fund a wallet using cryptocurrency.
        Required scope: `collection:crypto:create`.
      parameters:
        - name: Accept
          in: header
          schema:
            type: string
            default: application/json
          required: false
          description: Content type header.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InitiateCryptoRequest'
            example:
              amount: 25
              wallet_id: 9d469b3f-ca6c-4e82-8b4f-5f323c9ab03e
              network: MATIC_MAINNET
              token: USDT
      responses:
        '200':
          description: Crypto collection initiated successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InitiateCryptoResponse'
              example:
                message: Crypto collection initiated successfully.
                transaction:
                  transaction_id: fb87c0f8-31e3-46f3-b0d3-1ff2618565bc
                  reference: 7u5sXBFPA8IVDqV
                  token: USDT
                  token_amount: 25
                  network: MATIC_MAINNET
                  address: '0xdb664b89191eb50e0b45d7516c1adc2fcc327746'
                  status: PENDING
                  expires_at: '2024-02-26T14:24:15.000000Z'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Invalid or missing access token
      security:
        - oauth2ClientCredentials:
            - collection:crypto:create
components:
  schemas:
    InitiateCryptoRequest:
      type: object
      properties:
        amount:
          type: number
          minimum: 0.1
          description: Amount to collect (minimum 0.1).
        wallet_id:
          type: string
          description: Wallet ID to fund.
        network:
          type: string
          description: >-
            Blockchain network (e.g., ETHEREUM_MAINNET, MATIC_MAINNET,
            TRON_MAINNET).
        token:
          type: string
          description: Token to use (e.g., USDT, USDC).
        customer_id:
          type: string
          description: Existing customer ID to associate with the collection.
      required:
        - amount
        - wallet_id
        - network
        - token
    InitiateCryptoResponse:
      type: object
      properties:
        message:
          type: string
        transaction:
          $ref: '#/components/schemas/CryptoTransaction'
      required:
        - message
        - transaction
    Error:
      type: object
      properties:
        message:
          type: string
      required:
        - message
    CryptoTransaction:
      type: object
      properties:
        transaction_id:
          type: string
        reference:
          type: string
        token:
          type: string
        token_amount:
          type: number
        network:
          type: string
        address:
          type: string
        status:
          type: string
        expires_at:
          type: string
          format: date-time
      required:
        - transaction_id
        - reference
        - token
        - token_amount
        - network
        - address
        - status
        - expires_at
  securitySchemes:
    oauth2ClientCredentials:
      type: oauth2
      description: >-
        Use your OAuth client credentials to obtain a short-lived Bearer token
        from POST /oauth/token.
      flows:
        clientCredentials:
          tokenUrl: /oauth/token
          scopes:
            collection:crypto:create: Initiate crypto collections.

````