API Reference
FAQSandbox Portal

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.

🗓️

This endpoint is deprecated and will be sunset in January 2027. See the Legacy Endpoint Migration Guide for the replacement and migration status.

Body Params

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

string
enum
required

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

Allowed:
number
required

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

float
required

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

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.

string
required

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

string | null

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

number

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

Required for convertWalletPayout request.

number

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

Required for convertWithinWallets request.

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.

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

Updated 8 days ago

Did this page help you?
Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 8 days ago

Did this page help you?
Privacy policy Terms of service

VertoFX Ltd (No. 10973066) designs and operates the VertoFX website and app. VertoFX is authorised by the Financial Conduct Authority under the Electronic Money Regulations 2011, Firm Reference 901073, for the issuing of electronic money. Database rights protect data on VertoFX website(s) (including pricing data).

Please Note: we do NOT and WILL not deal with unregulated exchanges or affiliates as this currently falls outside of our risk appetite.

© Verto 2026

All rights reserved Registered Office: 20-22 Wenlock Road, London, England, N1 7GU