Skip to main content
POST
/
v1
/
ramp-requests
/
{id}
/
approve
Approve a ramp request
curl --request POST \
  --url https://api-fundflow.venly.io/v1/ramp-requests/{id}/approve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "version": 123
}'
{
  "success": true,
  "result": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "companyName": "<string>",
    "amount": 123,
    "netAmount": 123,
    "fiatAmount": 1000,
    "fiatNetAmount": 990,
    "cryptoAmount": 0.5,
    "fiatFeeAmount": 10,
    "exchangeRate": 2000,
    "feePercentage": 1,
    "paymentReference": "PAY-2024-001234",
    "paymentReceived": true,
    "blockchainTransactionHash": "0x1234...",
    "createdAt": "2023-11-07T05:31:56Z",
    "companyBankAccount": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "bankName": "<string>",
      "companyName": "<string>",
      "email": "<string>",
      "phoneNumber": "<string>",
      "bankCountry": "<string>",
      "beneficiaryAddressLine1": "<string>",
      "beneficiaryAddressLine2": "<string>",
      "beneficiaryCity": "<string>",
      "beneficiaryState": "<string>",
      "beneficiaryPostalCode": "<string>",
      "beneficiaryCountry": "<string>",
      "verifiedAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "version": 123,
      "iban": "<string>",
      "bic": "<string>",
      "intermediaryBic": "<string>"
    },
    "companyWallet": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "description": "<string>",
      "address": "<string>",
      "verifiedAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "version": 123
    },
    "depositBankAccount": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "bankName": "<string>",
      "beneficiary": "<string>",
      "fiatCurrency": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "currency": "EUR",
        "label": "Euro",
        "enabled": true,
        "version": 123
      },
      "label": "<string>",
      "isActive": true,
      "isDefault": true,
      "version": 123,
      "bic": "<string>",
      "intermediaryBic": "<string>",
      "iban": "<string>"
    },
    "depositWallet": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "address": "<string>",
      "label": "<string>",
      "isDefault": true,
      "isActive": true,
      "version": 123
    },
    "fiatCurrency": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "currency": "EUR",
      "label": "Euro",
      "enabled": true,
      "version": 123
    },
    "cryptoCurrency": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "currency": "USDC",
      "label": "USD Coin",
      "enabled": true,
      "version": 123,
      "coingeckoId": "<string>"
    },
    "events": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "userId": "<string>",
        "username": "<string>",
        "email": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "version": 123,
        "metadata": {}
      }
    ],
    "version": 123,
    "amountReceived": 123
  }
}
A Company Admin approves a request created by a Manager. After approval the status changes to AWAITING_FUNDS and deposit details are returned — a bank account for on-ramp, a wallet address for off-ramp. Send the current version for optimistic locking. Concept guide: Transactions
Requires the COMPANY_ADMIN role. Once approved, a request moves to AWAITING_FUNDS and can no longer be cancelled.

Authorizations

​
Authorization
string
header
required

OAuth2 authentication via Venly Identity Platform

Path Parameters

​
id
string<uuid>
required

Unique identifier of the ramp request

Body

application/json

Request containing only the version number for optimistic locking control

​
version
integer<int64>
required

Version number for optimistic locking. Must match the current version of the entity. If a version conflict occurs, fetch the latest version and retry.

Response

Ramp request successfully approved

​
success
boolean
default:true
​
result
object

Complete ramp request details including status, amounts, and event history