---
title: "Create Conversion"
method: POST
path: "/v1/conversion"
tags: ["Conversion"]
---

# Create Conversion

`POST /v1/conversion`

Create a new currency conversion within your UQPAY account balances. This allows you to exchange one currency for another at the available rate.
##### Usage Guidelines
- If using a pre-generated quote, provide a valid `quote_id`. The key conversion parameters (`buy_currency`, `sell_currency`, `conversion_date`) must match the quote details.
- Specify both `buy_currency` and `sell_currency`, but define only one of either `buy_amount` or `sell_amount`. The defined amount represents the dealt (fixed) side, while the other amount will be automatically calculated based on UQPAY's exchange rate.

## Headers

- `x-on-behalf-of` string
- `x-idempotency-key` string, uuid

## Request body

- CreateConversionRequest
  - `quote_id` string, required — A unique UUID identifier for the quote.
  - `sell_currency` string, required — Currency code [ISO_4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes).
  - `sell_amount` string — The amount of the currency that was sold in the conversion.
  - `buy_currency` string, required — Currency code [ISO_4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes).
  - `buy_amount` string — The amount of the currency that was purchased in the conversion.
  - `conversion_date` string, required — The designated date on which the currency conversion will be executed. This must be a valid available date for conversion. Only the current calendar date is supported — past or future dates are not allowed. Format: `YYYY-MM-DD`.

## Response `200`

OK - Successfully retrieved a payout.

- CreateConversionResponse
  - `conversion_id` string, required — A unique UUID identifier for the conversion transaction.
  - `short_reference_id` string, required — The reference generated by the system to identify the entity.
  - `sell_currency` string, required — Currency code [ISO_4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes).
  - `sell_amount` string, required — The amount of the currency that was sold in the conversion.
  - `buy_currency` string, required — Currency code [ISO_4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes).
  - `buy_amount` string, required — The amount of the currency that was purchased in the conversion.
  - `created_date` string, required — The timestamp when the conversion transaction was initiated.
  - `currency_pair` string, required — The currency pair that the quote is for. The direction of the currency pair is per market convention where possible.
  - `reference` string, required — The reference generated by the system to identify the entity.
  - `status` string, required — The current status of the conversion transaction. Valid values are: - `PROCESSING`: Currency conversion request is being processed by the system. - `AWAITING_FUNDS`: System is waiting for the source funds to be available. - `TRADE_SETTLED`: Currency exchange has been executed at the agreed rate. - `FUNDS_ARRIVED`: Converted funds have been received in the target currency.

---

[API](https://skmtc.dev/uqpay/apis/authentication-api.md) · [All operations](https://skmtc.dev/uqpay/apis/authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uqpay/authentication-api/revisions/cef532a10777/schema)