Skip to main content
POST
/
api
/
v2.1
/
fincard
/
virtual
/
account
/
transfer
Fund Transfer
curl --request POST \
  --url https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/account/transfer \
  --header 'Content-Type: application/json' \
  --header 'X-Forwarded-From: <x-forwarded-from>' \
  --data '
{
  "type": "<string>",
  "merchantOrderNo": "<string>",
  "fromAccountId": "wsb-abc123",
  "toAccountId": "wsb-abc124",
  "amount": 123,
  "description": "<string>",
  "currency": "<string>"
}
'
{
  "success": true,
  "code": 123,
  "msg": "<string>",
  "data": {
    "txId": 517581,
    "transactionId": 123,
    "accountId": "1979009257233215490",
    "currency": "USD",
    "amount": 4.08,
    "balanceBefore": 99327.04375,
    "balanceAfter": 99322.96375,
    "orderNo": "C2C_UZS_2025122307584616966",
    "bizType": "<string>",
    "transactionType": "<string>",
    "direction": "<string>",
    "remark": "<string>",
    "description": "<string>",
    "beforeBalance": "<string>",
    "afterBalance": "<string>",
    "createTime": 1766480100874,
    "updateTime": 123,
    "transactionStatus": "COMPLETED"
  }
}

Headers

User-Agent
string

User agent

X-Forwarded-For
string

Forwarded for

X-Forwarded-From
string
required

Client application identifier

Example:

"client-app"

X-Tenant-ID
string

Tenant ID

deviceId
string

Device ID

platform
string

Platform

Body

application/json

Fund transfer request

Fund transfer request

type
string
required

Operation type: TRANSFER or COLLECTION

merchantOrderNo
string
required

Client transaction reference. length[20...40]

fromAccountId
string
required

Source account ID (typically WALLET type)

Example:

"wsb-abc123"

toAccountId
string
required

Destination account ID (typically MARGIN type)

Example:

"wsb-abc124"

amount
number
required

Transfer amount

description
string

Transfer description

currency
string

Currency

Response

Transfer completed successfully

Fund transfer response

success
boolean

Success flag

code
integer<int32>

Response code

msg
string

Response message

data
object

Transaction data