Create FX Trade (New)

post

https://api-exchange-now-sandbox.vertofx.com/fx/payments

Create an FX trade between supported currency pairs, prepare convertWalletPayout sender details for planned validation, and handle review or RFI delays safely.

Body Params

An object containing all necessary details to initiate a payment as part of the foreign exchange transaction.

paymentType

string

enum

required

The type of payment you intend to make which is based on where you are sending the funds.

Allowed:

sourceWalletId

number

required

The wallet you intend to deduct the fund for the exchange.

sourceAmount

float

required

The amount you intend to deduct the fund from the provided wallet for the exchange.

purposeId

number

Use purposeId to state the purpose of the transfer of funds. Use the Get Purpose Codes API to get the purpose codes.

Required for convertWalletPayout request.

vfx_Token

string

required

The representation of the rate. This token is generated using the Get FX Rate API. The validity for which is 30 seconds.

customPaymentReference

string | null

You can use this to pass a reference that you'd like Verto to store.

targetAccountId

number

The id of beneficiary you intend to send the converted funds.

Required for convertWalletPayout request.

targetWalletId

number

The id of wallet you intend to send the converted funds.

Required for convertWithinWallets request.

paymentId

string

required

This helps us identify a unique payment request. If the same value is sent in a duplicate payment request, it will be rejected.

supportingDocS3Key

string

key obtained in generate an upload link in case client wants to attach supporting document.

sender

object

Business or Individual initiating the transaction

Responses

200Success

400Bad Request

401Unauthorized

403Forbidden

404Not Found

500Internal Server Error