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

# Initiate Espees Onramp

> Initiate a fiat → Espees (ESP) conversion. Submit the user's fiat currency, amount, and the bank account they are paying from. LINK returns the vendor banking details the user should send funds to.



## OpenAPI

````yaml /reference/link-transaction.json post /transactions/v2/esp_onramp
openapi: 3.1.0
info:
  title: link-transaction
  version: '1.0'
servers:
  - url: https://api.linkio.world
security:
  - sec0: []
tags:
  - name: Direct FX
  - name: Pan-Africa Ramp
  - name: BRL Ramp
  - name: IDR Ramp
  - name: B2B
  - name: Customers
  - name: Static Details
  - name: Transactions
  - name: Accounts
  - name: ESPESS
paths:
  /transactions/v2/esp_onramp:
    post:
      tags:
        - ESPESS
      summary: Initiate Espees Onramp
      description: >-
        Initiate a fiat → Espees (ESP) conversion. Submit the user's fiat
        currency, amount, and the bank account they are paying from. LINK
        returns the vendor banking details the user should send funds to.
      operationId: post_esp-onramp
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                currency:
                  type: string
                  description: Fiat currency the user is sending.
                  enum:
                    - AED
                    - AUD
                    - BRL
                    - CAD
                    - CNY
                    - DKK
                    - EUR
                    - GBP
                    - HKD
                    - ILS
                    - KES
                    - MXN
                    - NGN
                    - PHP
                    - SGD
                    - USD
                    - ZAR
                amount:
                  type: number
                  description: Amount of fiat to convert.
                bankName:
                  type: string
                  description: Name of the bank the user is paying from.
                accountNumber:
                  type: string
                  description: Account number the user is paying from.
                walletAddress:
                  type: string
                  description: >-
                    Espees wallet address to credit. Optional — provide at least
                    one identification field.
                kingschatUsername:
                  type: string
                  description: >-
                    KingsChat username linked to the user's Espees account.
                    Optional — provide at least one identification field.
                espeesCard:
                  type: string
                  description: >-
                    Espees card number. Optional — provide at least one
                    identification field.
                emailAddress:
                  type: string
                  description: >-
                    Email address registered with the user's Espees account.
                    Optional — provide at least one identification field.
              required:
                - currency
                - amount
                - bankName
                - accountNumber
      responses:
        '201':
          description: >-
            Transaction created successfully. Response includes the transaction
            record and `banking_details` — the account the user must transfer
            fiat to.
        '400':
          description: Missing or invalid request fields.
        '403':
          description: No banking details available for the requested currency.
        '500':
          description: Rate unavailable or internal server error.
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: ngnc-sec-key
      x-default: ''

````