Execute FX transfer between wallets

Request

🔒 Private label — contact sales. Requires a private-label entitlement on your API client.

Performs an internal fund transfer between two wallets with FX conversion. Auto-generates a reference if not provided.

Security

oauth2ClientCredentials(Required scopes: fx:write)

business_idstringrequired

Business identifier for the request

Bodyapplication/jsonrequired

amountnumberrequired

Transfer amount

Example:100

descriptionstringrequired

Transfer description

Example:"Internal transfer between accounts"

currencystringrequired

Currency code (ISO 4217)

Example:"USD"

fromWalletIdstringrequired

Source wallet ID

Example:"wallet_1"

toWalletIdstringrequired

Destination wallet ID

Example:"wallet_2"

referencestring

Reference (auto-generated if not provided)

Example:"FX_a1b2c3d4e5"

curl -i -X POST \
  https://developer.boyahq.com/_mock/v2/openapi/fx/transfer \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'business_id: string' \
  -d '{
    "amount": 100,
    "description": "Internal transfer between accounts",
    "currency": "USD",
    "fromWalletId": "wallet_1",
    "toWalletId": "wallet_2",
    "reference": "FX_a1b2c3d4e5"
  }'

Responses

FX transfer completed successfully