Create Quote

post

https://api-uat.eficyent.com/api/user/quotes/store1

Use this End point URL: https://api-uat.eficyent.com/api/user/quotes/store

This API generates a real-time currency conversion quote based on the selected source and destination currencies.

Users can specify the beneficiary type (Individual or Business), source currency or account, target currency, and amount. Based on these inputs, the API returns:

The applicable exchange rate
The converted amount in the target currency
The total payable amount in the source currency

Upon creation, the quote locks the exchange rate for a limited duration (approximately 30 minutes). During this validity period, users can proceed to confirm and complete the transaction using the returned quote ID, ensuring price consistency and transparency.

This API helps users accurately estimate and secure cross-border transaction values before proceeding with conversions or payouts.

Body Params

amount

string

required

recipient_type

integer

enum

required

Allowed:

recipient_country

string

required

ISO code - 3

receiving_currency

string

required

Defaults to USD

bank_account_id

string

required

The bank account id field is required when wallet id is not present

quote_type

string

enum

required

Allowed:

payment_rail

string

This field is required when the receiver currency is USD

wallet_id

string

The wallet id field is required when bank account id is not present

Headers

X-Merchant-Id

string

required

Identifies the merchant making the request.

X-Api-Key

string

required

Public API key associated with the merchant.

X-Api-Signature

string

required

RSA signature generated from the HMAC hash of the request payload.

X-Api-Timestamp

string

required

Current UNIX timestamp (in seconds). Used to prevent replay attacks.

X-Api-Nonce

string

required

Unique UUID per request

Responses

200Successful response

422Unprocessable Entity