Skip to main content
PATCH
/
v1
/
ramp-requests
/
{id}
/
initiate
Initiate an off-ramp request with transaction hash
curl --request PATCH \
  --url https://api-fundflow.venly.io/v1/ramp-requests/{id}/initiate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "version": 123,
  "blockchainTransactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
}
'
{
  "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
  }
}
After sending crypto to the Venly deposit wallet, submit the blockchainTransactionHash to initiate processing of an off-ramp request. Concept guide: Transactions

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 to add or update the blockchain transaction hash for a ramp request

​
version
integer<int64>
required

Version number for optimistic locking

​
blockchainTransactionHash
string
required

The transaction hash of the transfer of crypto funds to the Venly deposit wallet.

Minimum string length: 1
Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

Response

Transaction hash successfully updated

​
success
boolean
default:true
​
result
object

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