Create a Wallet Transfer (New)

Overview

Instantly transfers funds between two multi-currency wallets within your corporate entity (intra-company wallet movement) with zero slippage and instantaneous ledger settlement.

HTTP Request

POST /banking/ibans/v2/transfer

Authentication

This endpoint requires an active Bearer JWT token in the Authorization header obtained via POST /banking/ibans/v2/users/login:

Authorization: Bearer <your_access_token>

Request Body Fields

Field	Type	Description
amount	int	Sample value: 1000
currency	str	Sample value: USD
sourceWalletId	int	Sample value: 1
targetWalletId	int	Sample value: 2
description	str	Sample value: Internal funds movement
externalUniqueRef	str	Sample value: 71467f6d-58ed-400f-89b6-20db028fb498

Code Examples

cURL

curl -X POST "https://api.ahrvo.network/banking/ibans/v2/transfer" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your_access_token>" \
  -d '{
  "amount": 1000,
  "currency": "USD",
  "sourceWalletId": 1,
  "targetWalletId": 2,
  "description": "Internal funds movement",
  "externalUniqueRef": "71467f6d-58ed-400f-89b6-20db028fb498"
}'

JavaScript (Axios)

import axios from 'axios';

const response = await axios.post('https://api.ahrvo.network/banking/ibans/v2/transfer', {
  "amount": 1000,
  "currency": "USD",
  "sourceWalletId": 1,
  "targetWalletId": 2,
  "description": "Internal funds movement",
  "externalUniqueRef": "71467f6d-58ed-400f-89b6-20db028fb498"
}, {
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <your_access_token>'
  }
});

console.log(response.data);

Python (Requests)

import requests

url = "https://api.ahrvo.network/banking/ibans/v2/transfer"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <your_access_token>" 
}
payload = {
  "amount": 1000,
  "currency": "USD",
  "sourceWalletId": 1,
  "targetWalletId": 2,
  "description": "Internal funds movement",
  "externalUniqueRef": "71467f6d-58ed-400f-89b6-20db028fb498"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response (201)

{
  "amount": 200,
  "currency": "USD",
  "reference": "T0-28052024-046",
  "description": "Internal funds movement",
  "sourceWalletId": 3064,
  "targetWalletId": 3063,
  "state": "completed",
  "externalUniqueRef": "71467f6d-58ed-400f-89b6-20db028fb498"
}

Interactive API Explorer

Test this endpoint live against the Ahrvo gateway and Verto sandbox environments: