Create VertoFX Payment Request
Description:
The /integrations/vertofx/payment-requests
endpoint allows creation of new payment requests through VertoFX.
Method: POST
Request Payload:
Parameter | Type | Description |
---|---|---|
beneficiaryId | string | ID of the beneficiary to send payment to |
amount | number | Amount to be sent |
currency | string | Currency code |
walletId | string | ID of the wallet to send from |
reference | string | Payment reference |
memo | string | Optional memo for the payment |
curl --request POST \
--url https://server26-dot-royalti-project.uc.r.appspot.com/integrations/vertofx/payment-requests \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"beneficiaryId": "<string>",
"amount": 123,
"currency": "<string>",
"walletId": "<string>",
"reference": "<string>",
"memo": "<string>"
}'
{
"success": true,
"message": "Payment request created successfully",
"data": {
"paymentId": "vfx-payment-123",
"status": "pending"
}
}
JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"
Success
The response is of type object
.
curl --request POST \
--url https://server26-dot-royalti-project.uc.r.appspot.com/integrations/vertofx/payment-requests \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"beneficiaryId": "<string>",
"amount": 123,
"currency": "<string>",
"walletId": "<string>",
"reference": "<string>",
"memo": "<string>"
}'
{
"success": true,
"message": "Payment request created successfully",
"data": {
"paymentId": "vfx-payment-123",
"status": "pending"
}
}