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

# Get Crypto Bridge Deposit Status

> Retrieve detailed status of a crypto bridge transaction including all stages: deposit collection, crypto payment, and settlement.



## OpenAPI

````yaml GET /api/v3/deposit/crypto-bridge/status/{kotani_reference_id}
openapi: 3.0.0
info:
  title: KOTANI PAY API PLATFORM
  description: ''
  version: '3.0'
  contact: {}
servers:
  - url: https://preview.kotanipay.com
security: []
tags: []
paths:
  /api/v3/deposit/crypto-bridge/status/{kotani_reference_id}:
    get:
      tags:
        - CRYPTO BRIDGE DEPOSIT
      summary: Get crypto bridge deposit status
      description: >-
        Retrieve detailed status of a crypto bridge transaction including all
        stages: deposit collection, crypto payment, and settlement.
      operationId: DepositCryptoBridgeController_getCryptoBridgeStatus_api/v3
      parameters:
        - name: kotani_reference_id
          required: true
          in: path
          description: Kotani reference ID for the transaction
          schema:
            example: KOTANI-REF-789
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                properties:
                  success:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Crypto bridge deposit status retrieved.
                  data:
                    $ref: '#/components/schemas/CryptoBridgeStatusResponseDto'
                    type: object
        '400':
          description: ''
          content:
            application/json:
              schema:
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: Bad Request
                  data:
                    type: object
                    example: {}
        '401':
          description: ''
          content:
            application/json:
              schema:
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: Unauthorized
                  data:
                    type: object
                    example: {}
        '404':
          description: ''
          content:
            application/json:
              schema:
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: Transaction not found
                  data:
                    type: object
                    example: {}
      security:
        - JWT: []
components:
  schemas:
    CryptoBridgeStatusResponseDto:
      type: object
      properties:
        kotani_reference_id:
          type: string
          description: Kotani reference ID
          example: KOTANI-REF-789
        provider_reference_id:
          type: string
          description: Provider reference ID
          example: PROVIDER-TXN-20241122-001
        status:
          type: string
          enum:
            - DEPOSIT_INITIATED
            - DEPOSIT_CONFIRMED
            - PAYMENT_SENT
            - PAYMENT_CONFIRMED
            - SETTLING
            - COMPLETED
            - FAILED
            - REFUNDED
          description: Overall transaction status
          example: PAYMENT_SENT
        transaction_type:
          type: string
          enum:
            - cross_border
            - bridge
            - chain_settlement
          description: Transaction type
          example: cross_border
        chain:
          type: string
          enum:
            - CELO
            - ETHEREUM
            - ARBITRUM
            - AVALANCHE
            - BINANCE
            - POLYGON
            - OPTIMISM
            - FUSE
            - TRON
            - PROVENANCE
            - SOLANA
            - HEDERA
            - STELLAR
            - BASE
            - LISK
            - VICTION
            - SCROLL
            - LIGHTNING
          description: Chain being used
          example: LIGHTNING
        token:
          type: string
          enum:
            - CUSD
            - USDC
            - USDT
            - BUSD
            - HASH
            - HBAR
            - USDGLO
            - CKES
            - CGHS
            - MSAT
          description: Token being used
          example: MSAT
        stages:
          description: Detailed status of each transaction stage
          allOf:
            - $ref: '#/components/schemas/TransactionStagesDto'
        metadata:
          description: Transaction metadata
          allOf:
            - $ref: '#/components/schemas/TransactionMetadataDto'
      required:
        - kotani_reference_id
        - provider_reference_id
        - status
        - transaction_type
        - chain
        - token
        - stages
    TransactionStagesDto:
      type: object
      properties:
        deposit:
          description: Deposit stage status
          allOf:
            - $ref: '#/components/schemas/StageStatusDto'
        crypto_payment:
          description: Crypto payment stage status
          allOf:
            - $ref: '#/components/schemas/StageStatusDto'
        settlement:
          description: Settlement stage status
          allOf:
            - $ref: '#/components/schemas/StageStatusDto'
      required:
        - deposit
        - crypto_payment
        - settlement
    TransactionMetadataDto:
      type: object
      properties:
        sender_name:
          type: string
          description: Sender name
          example: John Doe
        sender_country:
          type: string
          description: Sender country code
          example: KE
        recipient_name:
          type: string
          description: Recipient name
          example: Jane Smith
        recipient_country:
          type: string
          description: Recipient country code
          example: ZA
        notes:
          type: string
          description: Additional notes or context
          example: Family support payment
    StageStatusDto:
      type: object
      properties:
        status:
          type: string
          enum:
            - DEPOSIT_INITIATED
            - DEPOSIT_CONFIRMED
            - PAYMENT_SENT
            - PAYMENT_CONFIRMED
            - SETTLING
            - COMPLETED
            - FAILED
            - REFUNDED
          description: Stage status
          example: DEPOSIT_CONFIRMED
        timestamp:
          type: string
          description: Stage completion timestamp (ISO 8601)
          example: '2024-11-22T12:00:45Z'
        amount:
          type: number
          description: Amount for this stage
          example: 1000
        currency:
          type: string
          description: Currency for this stage
          example: KES
        chain:
          type: string
          description: Chain for this stage
          example: LIGHTNING
        token:
          type: string
          description: Token for this stage
          example: MSAT
        payment_hash:
          type: string
          description: Payment hash
          example: a1b2c3d4e5f6...
        amount_msat:
          type: number
          description: Amount in millisatoshis (Lightning)
          example: 150000000
      required:
        - status
  securitySchemes:
    JWT:
      scheme: bearer
      bearerFormat: JWT
      type: http

````