Transfer

A transfer is the action of moving funds. Funds may be transferred between two Helix accounts, or one Helix account and an external account. Funds may not be transferred between two external accounts.

📘
One transfer typically creates exactly one transaction. However, if a fee (such as a RegD fee) or some other kind of surcharge applies, more than one transaction may be created.

Take me to the Transfer Endpoint Reference

transfer Object

Property	Data Type (length)	Description
`amount`	decimal	The amount of funds to transfer
`customerId`	integer	The Helix-assigned unique ID for the customer initiating the transfer.
`description`	string (255)	A client-specified description which will appear in the description property on the transaction object if the transfer is successful.
`fromId`	integer	The `accountId` or `externalAccountId` from which funds are being withdrawn. Note: this is not `accountNumber`.
`nachaDescription`	deprecated	Use `description` instead.
`purposeCode`	string (10)	The alphanumeric identifier describing the purpose of the transaction, is provided to the third-party fraud and risk vendor. These values are agreed upon by the bank of record and client during onboarding
`tag`	string (50)	A program-wide unique identifier in your system for this transfer which may be useful for search purposes. You will be able to search via this value in the Helix Admin Console. Must be unique for all transfers within your program. If transferring funds between two different customers' accounts, this is the `tag` that will be associated with the transaction on the sending (`fromId`) account.
`toId`	integer	The `accountId` or `externalAccountId` where funds are being sent/deposited. Note: this is not `accountNumber`.
`toCustomerId` *	integer	The Helix-assigned unique ID for the customer who owns the account receiving funds (if different from the customer sending funds)
`toCustomerTag` *	string (50)	The `tag` property of the customer who owns the account receiving funds (if different from the customer sending funds)
`toTransactionTag` *	string (50)	If transferring funds between two different customers' accounts, this is the `tag` that will be associated with the transaction on the receiving (`toId`) account. This value must be unique across all transactions within your program.

*Property relates to peer-to-peer (P2P) transfer functionality. Use of peer-to-peer (P2P) transfer functionality requires approval from Q2 and your bank partner.

Updated 21 days ago