API Reference
FAQSandbox Portal

Create a Payment Request (v2.2)

post
https://api-v3-sandbox.vertofx.com/profile/v2.2/request

This service is used to create a payment withdrawal request by specifying a walletID, amount, beneficiaryID, paymentId and a purposeID. You can also provide a custom client reference if needed and paymentId is unique uuid for unique reference.

Body Params
number
required

Id of the beneficiary you want to generate the payment request for. To get the Id use the response path response.body.data[].id Get all Beneficiaries API.

number
required

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

number
required

The amount you want to transfer.

number
required

The Id of the wallet, get the wallet id from the wallet list API.

string

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

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

Company or Individual initiating the transaction

Responses

Updated 12 months ago

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 12 months ago

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