---
title: "Generate a Quote"
method: POST
path: "/quotes/generate"
---

# Generate a Quote

`POST /quotes/generate`

This endpoint is used for generating a quote. Quotes are used to initiate conversions, cross-currency payout, or cross-currency checkout (coming soon).

## Request body

- object
  - `sourceCurrency` string, required — The currency which is used to fund a currency conversion or payout
  - `destinationCurrency` 'NGN' | 'USD' | 'EUR' | 'GBP' | 'GHS' | 'KES' | 'UGX' | 'TZX' | 'ZMW' | 'XAF' | 'XOF' | 'USDT' | 'USDC' | 'CNGN', required — The currency in which the recipient will be receiving funds
  - `amount` string, required — The transaction amount. With send action, it represents the amount being sent in the source currency. With receive action, it represents the amount to be received in the destination currency.
  - `action` 'send' | 'receive', required — Determines how amount is interpreted. send — quote returns how much the recipient will receive. receive — quote returns how much the sender must pay
  - `transactionType` 'conversion' | 'disbursement', required — If you want to make a payout, choose "disbursement," and if you want to convert a currency and receive the funds in your Fincra balance, choose "conversion.”
  - `business` string, required — The unique Identifier of the business
  - `feeBearer` 'customer' | 'business' — If you choose Customer, the fee would be deducted from the amount the beneficiary will receive. If you choose business, the fee would be deducted business balance for a cross-currency payout.
  - `paymentDestination` 'bank_account' | 'fliqpay_wallet' | 'mobile_money_wallet' | 'crypto_wallet', required — This is the type of account you want to send your payments to. For conversions the payment destination must always be `fliqpay_wallet` and for payouts the payment destination must always be `bank_account` , `mobile_money_wallet` or `crypto_wallet`
  - `paymentScheme` 'swift' | 'ach' | 'fps' | 'sepa' | 'sepa_instant' | 'chaps' | 'fed_wire' | 'usdt_erc20' | 'usdt_trc20' | 'usdt_solana' | 'usdt_bep20' | 'usdc_erc20' | 'usdc_solana' — This is the valid payment scheme for the destination currency you want to generate a quote for. This is only required when the transaction type is disbursement(to foreign currencies or crypto wallet) and not conversion
  - `beneficiaryType` 'individual' | 'corporate' — The beneficiary type e.g individual or corporate. This is necessary in order to generate quotes for all African currencies.
  - `delay` boolean — This is only required when payment integration method is "Global Collections"

## Response `200`

200

- union
  - object
    - `success` boolean
    - `message` string
    - `data` object
      - `sourceCurrency` string
      - `destinationCurrency` string
      - `sourceAmount` integer
      - `destinationAmount` number
      - `action` string
      - `transactionType` string
      - `fee` integer
      - `initialAmount` integer
      - `quotedAmount` number
      - `rate` number
      - `amountToCharge` integer
      - `amountToReceive` integer
      - `reference` string
      - `expireAt` string
      - `settlementDate` string
  - object
    - `success` boolean
    - `message` string
    - `data` object
      - `sourceCurrency` string
      - `destinationCurrency` string
      - `sourceAmount` integer
      - `destinationAmount` number
      - `action` string
      - `transactionType` string
      - `fee` integer
      - `initialAmount` integer
      - `quotedAmount` number
      - `rate` number
      - `amountToCharge` integer
      - `amountToReceive` integer
      - `reference` string
      - `expireAt` string
      - `feeCurrency` string
      - `feeRate` integer

---

[API](https://skmtc.net/fincra/apis/awesome-new-api.md) · [All operations](https://skmtc.net/fincra/apis/awesome-new-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fincra/awesome-new-api/revisions/c8215c27b460/schema)