Skip to main content
POST
/
integrations
/
vertofx
/
payment-requests
/
v2
Create VertoFx Payment Request (v2)
curl --request POST \
  --url https://server26-dot-royalti-project.uc.r.appspot.com/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"
}
Creates a new payment request in VertoFx (v2 API).

​
Authentication

This endpoint requires authentication. Include your bearer token in the Authorization header.

​
Request Body

​
Request Schema

FieldTypeRequiredDescription
amountnumber✅Amount to send.
currencystring✅Currency code.
beneficiarystring✅Beneficiary ID.
purposeCodestring✅Purpose code for payment.

​
Responses

​
✅ 201 - Payment request created

​
⚠️ 400 - Bad Request

​
⚠️ 401 - Unauthorized

​
❌ 500 - Internal Server Error

​
Tags

VertoFx

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"

⌘I