Transfers

Transfers facilitate the movement of assets between accounts, enabling transactions such as payments and withdrawals.

Endpoints:

• GET List Transfers: GET /transfers
• POST Initiate a Transfer: POST /transfers
• GET Get a single Transfer: GET /transfers/{uid}
• PUT Cancel a Transfer: PUT /transfers/{uid}/cancel

A Transfer is the Action of moving assets between two Synthetic Accounts. Most asset movement initiated by your application will result in a Transfer. Asset movement is determined by the makeup of assets in both participating accounts, the Synthetic Account Type of the participating accounts, the available Custodial Accounts for all participating Customers, and the overall Program configuration. A Transfer can never be initiated between two external accounts.

Company ID Behavior

The company_id field is optional when initiating a transfer. However, it becomes required if your organization has multiple company IDs or multiple custodial accounts, to ensure accurate routing of funds. If provided, the value will be validated.

In sandbox environments:

• company_id is optional and will be validated if supplied.
• company_id and custodial accounts are always in a 1:1 relationship.

Note Any time a Transfer is created, it creates 1+ Transactions, which are returned in the response payload for a successful Transfer. Please note or record these uids, as they will be needed to query the Transaction object and any associated key data points. For instance, Fed IMAD or CHIPS SSN is used for outgoing wires.

New Optional Field: Purpose_of_Payment

A new optional field, purpose_of_payment, was added to the Initiate a Transfer (POST /transfers) endpoint. This field accepts a purpose code indicating the reason for an instant payment transfer.

When provided, the value must be one of the following supported codes:

If the field is omitted or sent as an empty string, it is treated as not set. Only transfers initiated as Newline instant payments support this field.

Important Note: An additional code, TRAD, will be added in September to support Predicative Market transactions.