Create an FX trade to convert wallet funds and either pay out to a beneficiary or move funds into another wallet.
Sender information
The sender object is required when using convertWalletPayout as the paymentType and you are a fintech or financial institution making a payout on behalf of an underlying customer from your master wallet. It is not required for convertWithinWallets transfers.
Not required if you are:
- An Atlas for Platform client — sender identity is established through the sub-account's KYB data
- A corporate sending on your own principal basis (e.g. supplier payments, payroll, merchant settlements)
- Initiating a payout from a sub-account — sender information is inherited from the sub-account directly
If you are unsure whether your use case requires a sender object, contact [email protected] before going live. See the Sender object guide for full field requirements.
NOTE:
Always confirm your Base URL: If you are testing in the sandbox environment, ensure your base URL is set to the sandbox base url: https://api-company-sandbox.vertofx.com, and if in production, use the production base URL: https://api-company-beta.vertofx.com. Using them interchangably will result in 403 errors.