POST

/BizTransaction/Transfer

Usage Notes

When

  • Move units between accounts within the same investment
  • Transfer holdings for ownership changes or restructuring
  • Execute account-to-account movements

Requirements

  • Both source and destination accounts must exist
  • Both accounts must hold the same investment
  • Source account must have sufficient holdings

Notes

  • Creates TWO linked BizTransaction records (from-account and to-account)
  • Response returns array with both transaction records
  • Units transferred at consistent pricing

Description

Creates a transfer that moves units from one account to another within the same investment. Returns TWO linked transaction records for complete audit trail of the movement.

Required Headers - See Authentication

HeaderValueDescription
Content-Typeapplication/jsonRequest content type
Authorization{accessToken}Bearer token for API access
Version2.0API version identifier

Request Body

Parameter Type Required Description
price >
number (double)
Manual price override when priceMethod='Override' (applies to both from-reduction and to-increase transactions).
quantity >
number (double)
Exact unit quantity to transfer (creates TWO BizTransaction records: from-account with negative quantity, to-account with positive quantity).
priceMethod >
string
Pricing method for both transactions (values: 'Market'=current investmentPrice, 'Book'=historical cost base, 'Override'=manual price parameter).
noChangeOfBeneficialOwner >
boolean
Beneficial owner flag indicating whether the transfer involves a change of beneficial ownership (TRUE=no change, FALSE=change of owner).
investmentID >
integer (int32)
Native investment identifier (transfers within SAME investment across accounts, for investment switching use Conversion endpoint instead).
externalInvestmentId >
string
External investment identifier for cross-platform integration.
fromAccountID >
integer (int32)
Source account identifier (creates negative-quantity transaction reducing holdings, can belong to different BizEntity than to-account).
fromExternalAccountId >
string
External source account identifier for cross-platform integration.
fromComment
 string
Optional
Comment for outgoing transfer transaction (appears on from-account investor statements).
fromExternalBizTransactionId
 string
Optional
External identifier for outgoing transfer transaction for idempotency (separate from to-transaction ID).
toAccountID >
integer (int32)
Destination account identifier (creates positive-quantity transaction increasing holdings, can belong to different BizEntity than from-account).
toExternalAccountId >
string
External destination account identifier for cross-platform integration.
toComment
 string
Optional
Comment for incoming transfer transaction (appears on to-account investor statements).
toExternalBizTransactionId
 string
Optional
External identifier for incoming transfer transaction for idempotency (separate from from-transaction ID).
transactionDate >
string (date)
Transaction date for both transfer records. Format: YYYY-MM-DD. Same date used for both from/to transactions. Cannot be empty or default value.
productID >
integer (int32)
Native product identifier validating investment and accounts belong to correct fund structure.
externalProductId >
string
External product identifier for cross-system product correlation.
price
number (double)
Manual price override when priceMethod='Override' (applies to both from-reduction and to-increase transactions).
quantity
number (double)
Exact unit quantity to transfer (creates TWO BizTransaction records: from-account with negative quantity, to-account with positive quantity).
priceMethod
string
Pricing method for both transactions (values: 'Market'=current investmentPrice, 'Book'=historical cost base, 'Override'=manual price parameter).
noChangeOfBeneficialOwner
boolean
Beneficial owner flag indicating whether the transfer involves a change of beneficial ownership (TRUE=no change, FALSE=change of owner).
investmentID
integer (int32)
Native investment identifier (transfers within SAME investment across accounts, for investment switching use Conversion endpoint instead).
externalInvestmentId
string
External investment identifier for cross-platform integration.
fromAccountID
integer (int32)
Source account identifier (creates negative-quantity transaction reducing holdings, can belong to different BizEntity than to-account).
fromExternalAccountId
string
External source account identifier for cross-platform integration.
fromComment
string
Optional
Comment for outgoing transfer transaction (appears on from-account investor statements).
fromExternalBizTransactionId
string
Optional
External identifier for outgoing transfer transaction for idempotency (separate from to-transaction ID).
toAccountID
integer (int32)
Destination account identifier (creates positive-quantity transaction increasing holdings, can belong to different BizEntity than from-account).
toExternalAccountId
string
External destination account identifier for cross-platform integration.
toComment
string
Optional
Comment for incoming transfer transaction (appears on to-account investor statements).
toExternalBizTransactionId
string
Optional
External identifier for incoming transfer transaction for idempotency (separate from from-transaction ID).
transactionDate
string (date)
Transaction date for both transfer records. Format: YYYY-MM-DD. Same date used for both from/to transactions. Cannot be empty or default value.
productID
integer (int32)
Native product identifier validating investment and accounts belong to correct fund structure.
externalProductId
string
External product identifier for cross-system product correlation.

Example Requests

bash
# Tax-deferred transfer (same beneficial owner)
curl -X POST 'https://api.7g.com.au/BizTransaction/Transfer' \
  -H 'Authorization: {accessToken}' \
  -H 'Version: 2.0' \
  -H 'Content-Type: application/json' \
  -d '{
    "quantity": 50000.00,
    "priceMethod": "Market",
    "noChangeOfBeneficialOwner": true,
    "investmentID": 25,
    "fromAccountID": 12345,
    "fromComment": "Transfer to spouse account - tax deferred",
    "toAccountID": 12346,
    "toComment": "Received from spouse account - tax deferred",
    "transactionDate": "2025-08-14",
    "productID": 10
  }'

# Transfer with change of ownership (taxable event)
curl -X POST 'https://api.7g.com.au/BizTransaction/Transfer' \
  -H 'Authorization: {accessToken}' \
  -H 'Version: 2.0' \
  -H 'Content-Type: application/json' \
  -d '{
    "price": 1.25,
    "quantity": 25000.00,
    "priceMethod": "Override",
    "noChangeOfBeneficialOwner": false,
    "investmentID": 25,
    "fromAccountID": 12345,
    "toAccountID": 12346,
    "transactionDate": "2025-08-14",
    "productID": 10
  }'

Response Examples

json
{
  "result": true,
  "message": "Transfer processed successfully",
  "recordCount": 2,
  "data": [
    {
      "bizTransactionID": 6001,
      "externalBizTransactionId": "TRF-OUT-2024-001",
      "bizTransactionTypeID": 4,
      "typeName": "Transfer Out",
      "movementReasonCode": "ACCOUNT_TRANSFER",
      "parentBizTransactionID": null,
      "transactionDate": "2025-08-14T00:00:00Z",
      "productID": 10,
      "externalProductId": "FUND-001",
      "accountID": 12345,
      "externalAccountId": "ACC-12345",
      "accountNumber": "ACC001234",
      "bizEntityName": "John Smith",
      "investmentID": 25,
      "externalInvestmentId": "INV-GROWTH",
      "securityCode": "GRW001",
      "investmentName": "Growth Investment Class A",
      "investmentPrice": 1.2500,
      "comment": "Transfer to spouse account - tax deferred",
      "corporateActionID": null,
      "externalCorporateActionId": null,
      "corporateActionName": null,
      "amount": -62500.00,
      "quantity": -50000.00,
      "transactionClosingAmount": null,
      "transactionClosingQuantity": null,
      "accountClosingAmount": null,
      "accountClosingQuantity": null,
      "createdDate": "2025-08-14T10:30:15Z",
      "updatedDate": null,
      "bizTransactionStatusID": 1,
      "statusName": "Complete"
    },
    {
      "bizTransactionID": 6002,
      "externalBizTransactionId": "TRF-IN-2024-001",
      "bizTransactionTypeID": 8,
      "typeName": "Transfer In",
      "movementReasonCode": "ACCOUNT_TRANSFER",
      "parentBizTransactionID": null,
      "transactionDate": "2025-08-14T00:00:00Z",
      "productID": 10,
      "externalProductId": "FUND-001",
      "accountID": 12346,
      "externalAccountId": "ACC-12346",
      "accountNumber": "ACC001235",
      "bizEntityName": "Mary Smith",
      "investmentID": 25,
      "externalInvestmentId": "INV-GROWTH",
      "securityCode": "GRW001",
      "investmentName": "Growth Investment Class A",
      "investmentPrice": 1.2500,
      "comment": "Received from spouse account - tax deferred",
      "corporateActionID": null,
      "externalCorporateActionId": null,
      "corporateActionName": null,
      "amount": 62500.00,
      "quantity": 50000.00,
      "transactionClosingAmount": null,
      "transactionClosingQuantity": null,
      "accountClosingAmount": null,
      "accountClosingQuantity": null,
      "createdDate": "2025-08-14T10:30:16Z",
      "updatedDate": null,
      "bizTransactionStatusID": 1,
      "statusName": "Complete"
    }
  ]
}
GET Get BizTransactions POST Conversion POST Deposit GET Get Account Holdings