| Status | Description |
|---|---|
queued | Transfers begin in the queued status. queued indicates that Newline has received a valid Transfer request and is preparing the Transfer. |
pending | Transfers move from a status of queued to a status of pending. A pending status indicates that Newline has begun the movement of funds to complete the Transfer. |
canceled | Transfers must be canceled by the originating Customer (or Authorized Representative). Transfers can only enter the canceled state if Newline receives a request while the aforementioned Transfer is in queued or pending states. A pending state cancellation is not guaranteed as this state also includes payment execution. At that stage, a cancel request will result in an error. |
failed | The Transfer has failed. This may occur due to a system error, or problems with the origin and/or destination account. A new Transfer must be created to move the assets. |
settled | The Transfer is complete and the funds have settled in the destination Synthetic account. |
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_idis optional and will be validated if supplied.company_idand custodial accounts are always in a 1:1 relationship.