Fund Later

Lock a rate now and fund the order within 24 hours. Once Verto detects your incoming funds — typically within 15 minutes of receipt — the trade executes automatically at the locked rate.

Best for clients who want to fix a rate before arranging funding, or where booking and funding happen in sequence rather than simultaneously.

How it works

1. Get a quote with paymentMode set to later — the rate is locked and a pending trade is created
2. Fund the order within 24 hours by sending the required funds to Verto
3. Verto detects the incoming payment within 15 minutes and executes the trade automatically
4. Receive webhook notifications as the trade progresses

Step 1 — Get a quote

Call the Get FX Rate endpoint with paymentMode set to later. You must specify the amount, amount currency, and currencies.

{
  "paymentMode": "later",
  "currencyFrom": {
    "currencyName": "USD"
  },
  "currencyTo": {
    "currencyName": "KES"
  },
  "amount": 5000,
  "amountCurrency": "USD"
}

The response returns a rate and a vfxToken that locks the quote for the order.

{
  "rate": 0.00167025,
  "vfxToken": "eyJhbGci...",
  "expiry": "2024-05-10T10:22:49.994Z",
  "success": true
}

⚠️

Retain the vfxToken — it is required to book the trade in Step 2.

Step 2 — Book the trade

Call the Create FX Trade endpoint with the vfxToken from Step 1. This creates a pending trade at the locked rate. The trade will not execute until funds are received.

{
  "paymentType": "convertWalletPayout",
  "sourceWalletId": 11435,
  "sourceAmount": 5000,
  "purposeId": 14,
  "vfxToken": "eyJhbGci...",
  "customPaymentReference": "your-reference",
  "targetAccountId": 23181,
  "paymentId": "a7c01c2d-f677-41d8-a11c-4d66804669f4"
}

Step 3 — Fund the order

Send the required funds to Verto within 24 hours of booking. Once received, Verto will detect the incoming payment within 15 minutes and execute the trade automatically at the locked rate.

⚠️

Funding deadline

If funds are not received within 24 hours, the locked rate will expire. A new quote must be obtained before a new trade can be booked.

Payment statuses

You will receive webhook notifications as the trade progresses. Note that if the trade is booked outside of business hours, there may be a delay between funding and execution.

API response states

Webhook transaction states