Move funds

Move balance between accounts

post

Transfers funds between your Proprietary (Owner) account and your Transactional account.

Header parameters

Content-TypestringRequiredDefault: application/json

X-DatestringRequired

ISO8601 Datetime with Timezone: yyyy-MM-dd'T'HH:mm:ssZ

Example: 2025-12-03T08:38:02.153Z

X-LoginstringRequired

Merchant X-Login API Key

AuthorizationstringRequired

Authorization control hash (Signature)

X-Idempotency-Keystring · uuidRequired

Unique key to prevent duplicate transactions

Body

application/json

sourcestring · enumRequired

The account funds are being taken from.

Example: TRANSACTIONALPossible values:

destinationstring · enumRequired

The account funds are being sent to.

Example: PROPRIETARYPossible values:

currencystringRequired

3-letter ISO currency code.

Example: BRL

amountnumber · floatRequired

The value to transfer.

Example: 100.5

Responses

200

Successful Transfer

application/json

post

/v1/wallet/transaction

HTTPcURLJavaScriptPython

POST /v1/wallet/transaction HTTP/1.1
Host: api-stg.onekeypayments.com
Content-Type: application/json
X-Date: 2025-12-03T08:38:02.153Z
X-Login: text
Authorization: text
X-Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000
Accept: */*
Content-Length: 86

{
  "source": "TRANSACTIONAL",
  "destination": "PROPRIETARY",
  "currency": "BRL",
  "amount": 100.5
}

200

Successful Transfer

{
  "currency": "BRL",
  "proprietary_balance": 1500,
  "transactional_balance": 250
}