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

# Initiate Collection

> Initiates a fiat collection for a customer, generating a one-time virtual bank account for them to pay into. Requires a Business account. Only NGNX (fiat) collections are supported at this time.



## OpenAPI

````yaml /api-reference/openapi.json post /collections
openapi: 3.0.0
info:
  title: Obiex API
  version: 1.0.0
  description: >-
    Welcome to the Obiex API Documentation, your guide to building amazing
    payment experiences with our powerful APIs.


    Start by reviewing the overview of each folder to understand how the APIs
    function and interact. This will help you get the most out of our platform
    and easily integrate its features into your applications.
servers:
  - url: https://api.obiex.finance/v1
security: []
paths:
  /collections:
    post:
      tags:
        - Collections
      summary: Initiate Collection
      description: >-
        Initiates a fiat collection for a customer, generating a one-time
        virtual bank account for them to pay into. Requires a Business account.
        Only NGNX (fiat) collections are supported at this time.
      parameters:
        - name: X-API-KEY
          in: header
          required: false
          deprecated: false
          schema: {}
        - name: X-API-TIMESTAMP
          in: header
          required: false
          deprecated: false
          schema: {}
        - name: X-API-SIGNATURE
          in: header
          required: false
          deprecated: false
          schema: {}
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                customer:
                  type: object
                  properties:
                    firstName:
                      type: string
                    lastName:
                      type: string
                    bvn:
                      type: string
                      description: 11-digit Bank Verification Number
                    nin:
                      type: string
                      description: 11-digit National Identification Number
                collectionType:
                  type: string
                  enum:
                    - FIAT
                    - CRYPTO
                  default: FIAT
                currency:
                  type: string
                amount:
                  type: number
            example:
              customer:
                firstName: Ada
                lastName: Okafor
                bvn: '22212345678'
                nin: '11198765432'
              collectionType: FIAT
              currency: NGNX
              amount: 5000
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
              example:
                message: Ok
                data:
                  customerId: 9b1d6a3d-df3e-4e33-9f2b-1c2e3a9b6a11
                  transactionReference: col_9f639b9f2a4a4b0e8e0e2d9c9d7a9d3e
                  collectionType: FIAT
                  expiresAt: '2026-08-17T10:47:00.000Z'
                  account:
                    bankName: Wema Bank
                    accountName: Obiex-Ada Okafor
                    accountNumber: '9012345678'
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````