Skip to main content
POST
/
integrations
/
vertofx
/
payment-requests
/
v2
Create VertoFx Payment Request (v2)
curl --request POST \
  --url https://api.royalti.io/integrations/vertofx/payment-requests/v2 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 1000,
  "currency": "USD",
  "beneficiary": "beneficiary_123",
  "purposeCode": "INV"
}
'
{
  "id": "req_123456",
  "status": "pending",
  "amount": 1000,
  "currency": "USD"
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Code Examples

const response = await fetch('https://api.royalti.io/integrations/vertofx/payment-requests/v2', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "amount": 1000,
    "currency": "USD",
    "beneficiary": "beneficiary_123",
    "purposeCode": "INV"
  })
});

const data = await response.json();
console.log(data);

Authorizations

​
Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Body

application/json
​
amount
number
required

Amount to send.

Example:

1000

​
currency
string
required

Currency code.

Example:

"USD"

​
beneficiary
string
required

Beneficiary ID.

Example:

"beneficiary_123"

​
purposeCode
string
required

Purpose code for payment.

Example:

"INV"

Response

Payment request created

​
id
string
Example:

"req_123456"

​
status
string
Example:

"pending"

​
amount
number
Example:

1000

​
currency
string
Example:

"USD"