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

# Crear deposito ACH con conversion crypto a BOB

> Genera una direccion y un monto crypto para fondear la cuenta de comercios del negocio autenticado. amount representa los BOB a recibir. Tras la confirmacion del monto crypto completo, se solicita el ACH desde la cuenta de Mesa de Pagos. La operacion se registra como prefunding con fundingSource conversion y sus cambios de estado se notifican por transaction_updated. externalReference debe ser unica. Los importes de la respuesta se expresan como strings decimales.



## OpenAPI

````yaml /openapi-v3.yaml post /v3/transactions/deposit/ach
openapi: 3.0.0
info:
  title: YP API Partner
  description: Documentación de integración para partners de YP API.
  version: v3
  contact: {}
servers:
  - url: https://sandbox-rampa.mesadepagos.com/api
    description: Sandbox
security: []
tags:
  - name: Auth
    description: ''
  - name: Quotes
    description: ''
  - name: Payin
    description: ''
  - name: Payout
    description: ''
  - name: Wallet
    description: ''
  - name: Consultas
    description: ''
  - name: Webhooks
    description: ''
  - name: Fees
    description: ''
  - name: Clients
    description: ''
  - name: Client verifications
    description: Las verificaciones que habilitan a un cliente a cobrar a su nombre.
  - name: Virtual accounts
    description: 'Las cuentas de cobro: las del partner y las de sus clientes.'
paths:
  /v3/transactions/deposit/ach:
    post:
      tags:
        - Payin
      summary: Crear deposito ACH con conversion crypto a BOB
      description: >-
        Genera una direccion y un monto crypto para fondear la cuenta de
        comercios del negocio autenticado. amount representa los BOB a recibir.
        Tras la confirmacion del monto crypto completo, se solicita el ACH desde
        la cuenta de Mesa de Pagos. La operacion se registra como prefunding con
        fundingSource conversion y sus cambios de estado se notifican por
        transaction_updated. externalReference debe ser unica. Los importes de
        la respuesta se expresan como strings decimales.
      operationId: createDepositAchV3
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateDepositAchRequestV3Doc'
      responses:
        '201':
          description: Deposito pendiente de recibir crypto.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateDepositAchResponseV3Doc'
        '400':
          description: >-
            Request invalido, monto crypto no positivo o cuenta de comercios no
            disponible.
        '401':
          description: Token ausente, invalido o expirado.
        '409':
          description: La referencia externa ya existe.
        '500':
          description: >-
            Configuracion incompleta o fallo al cotizar, crear la direccion o
            guardar el deposito.
      security:
        - bearer: []
components:
  schemas:
    CreateDepositAchRequestV3Doc:
      type: object
      properties:
        assetDeposit:
          type: string
          enum:
            - USDC
            - USDT
          example: USDC
        blockchain:
          type: string
          enum:
            - Ethereum
            - Polygon
          example: Polygon
        amount:
          type: number
          example: 696
          minimum: 0
          exclusiveMinimum: true
          maximum: 999999999999.99
          multipleOf: 0.01
          description: Monto BOB a abonar a la cuenta de comercios del negocio autenticado.
        externalReference:
          type: string
          example: DEPOSIT-1001
          minLength: 1
          maxLength: 100
      required:
        - assetDeposit
        - blockchain
        - amount
        - externalReference
    CreateDepositAchResponseV3Doc:
      type: object
      properties:
        transactionId:
          type: string
          format: uuid
        transactionStatus:
          type: string
          enum:
            - pending_transaction
            - pending_approval
            - processing_transaction
            - completed_transaction
            - reject_transaction
            - expired_transaction
            - cancelled_transaction
            - failed_transaction
            - received_transaction
            - returned_transaction
            - insufficient_funds
          example: pending_transaction
        externalReference:
          type: string
          example: DEPOSIT-1001
        cryptoAmount:
          type: string
          example: '100.00000000'
          description: >-
            Monto crypto que debe recibirse para ejecutar el abono, incluido el
            descuento configurado.
        fiatAmount:
          type: string
          example: '696.00'
        fiatCurrency:
          type: string
          enum:
            - BOB
          example: BOB
        depositAddress:
          type: string
          example: '0x0000000000000000000000000000000000000000'
          description: Direccion unica para recibir el asset en la blockchain solicitada.
        exchangeRate:
          type: string
          example: '6.96000000'
          description: Tipo de cambio aplicado, expresado en BOB por unidad crypto.
        asset:
          type: string
          enum:
            - USDC
            - USDT
          example: USDC
        blockchain:
          type: string
          enum:
            - Ethereum
            - Polygon
          example: Polygon
      required:
        - transactionId
        - transactionStatus
        - externalReference
        - cryptoAmount
        - fiatAmount
        - fiatCurrency
        - depositAddress
        - exchangeRate
        - asset
        - blockchain
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: JWT obtenido desde /v2/auth/login o /v3/auth/login

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.