Update a EFT Canada Transfer

To cancel a transfer, update the status to ‘CANCELLED’. Only ‘INITIATED’ or ‘PENDING` transfers can be cancelled.

🚧 Beta > This is a Beta endpoint. Feedback from the community is welcome. We may make breaking changes.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key · string

An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry.

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

Path Parameters

id · string<uuid> · required

EFT Canada Transfer ID

Body

application/json

Properties of the EFT Canada transfer to update.

Properties for updating a transfer

source_data · object

Additional information to be added to the transfer

status · enum<string>

Available options:

CANCELLED

Response

200

application/json

The updated EFT Canada transfer.

EFT transfer specific to Canada

amount · integer · required

Transfer amount in cents

Required range: x >= 1

Example:

10000

customer_id · string<uuid> · required

The UUID of the Synctera customer resource that is the originator of the transfer.

Example:

"46fec39e-e776-4571-bf90-d0e1d15172fe"

dc_sign · enum<string> · required

Debit or credit sign

Available options:

CREDIT,

DEBIT

Example:

"DEBIT"

transaction_code · string · required

The three digit transaction code that identifies the type of transaction. More information can be found here: https://www.payments.ca/sites/default/files/standard007eng.pdf.

Example:

304

destination_account_id · string<uuid> · required

The UUID of the Synctera account that is the destination of the transfer. For a transfer originated by the Synctera platform, this will be an external account resource, while for a transfer originated by the external account, this account will be an account resource.

Example:

"fccb4a46-1261-4e91-b622-73b5b946183d"

destination_account_number · string<string> · required

The account number of the destination account.

Example:

1344012344

destination_account_owner_name · string · required

The account owner name of the destination account.

effective_date · string<date> · required

The effective date of the transaction once it gets posted

Example:

"2022-03-18"

id · string<uuid> · required

ID of the transfer

is_same_day · boolean · required

Send the same day (use only is_same_day without specific effective_date).

Example:

true

originating_account_id · string<uuid> · required

The UUID of the Synctera account that is the origination of the transfer. For a transfer originated by the Synctera platform, this will be an account resource, while for a transfer originated by the external account, this will be an external account resource.

Example:

"b01db9c7-78f2-4a99-8aca-1231d32f9b96"

originating_account_number · string<string> · required

The account number of the originating account.

Example:

1961234745

originating_account_owner_name · string · required

The account owner name of the origination account.

reference_id · string · required

The reference id of the transfer.

Example:

123456789

status · enum<string> · required

The status of the transfer in the Synctera platform. This is automatically set upon the creation of a transfer. To cancel a transfer, the current status must be 'INITIATED' or 'PENDING' and the request status set to 'CANCELLED'. To trigger a return, the current status must be 'POSTED' and the returned status will be set to 'RETURNED' if successful.

Available options:

CANCELLED,

EXPIRED,

INITIATED,

IN_SUSPENSE,

PENDING,

POSTED

Example:

"POSTED"

subtype · enum<string> · required

The subtype of the transfer

Available options:

BULK_OUTGOING_CREDIT,

BULK_OUTGOING_CREDIT_RETURN,

BULK_OUTGOING_CREDIT_RETURN_REVERSAL,

BULK_OUTGOING_CREDIT_REVERSAL,

BULK_OUTGOING_DEBIT,

BULK_OUTGOING_DEBIT_RETURN,

BULK_OUTGOING_DEBIT_RETURN_REVERSAL,

BULK_OUTGOING_DEBIT_REVERSAL,

INCOMING_CREDIT,

INCOMING_CREDIT_RETURN,

INCOMING_CREDIT_RETURN_REVERSAL,

INCOMING_CREDIT_REVERSAL,

INCOMING_DEBIT,

INCOMING_DEBIT_RETURN,

INCOMING_DEBIT_RETURN_REVERSAL,

INCOMING_DEBIT_REVERSAL,

OUTGOING_CREDIT,

OUTGOING_CREDIT_RETURN,

OUTGOING_CREDIT_RETURN_REVERSAL,

OUTGOING_CREDIT_REVERSAL,

OUTGOING_DEBIT,

OUTGOING_DEBIT_RETURN,

OUTGOING_DEBIT_RETURN_REVERSAL,

OUTGOING_DEBIT_REVERSAL

Example:

"INCOMING_CREDIT"

tenant_id · string · required

The id of the tenant containing the resource. This is relevant for Fintechs that have multiple workspaces.

Example:

"abcdef_ghijkl"

source_data · object

Additional information to be added to the transfer

failed · boolean

Whether the transfer failed or not.

Example:

false

history · object[]

Show child attributes

network_status · enum<string>

The network status of the transfer.

Available options:

PENDING,

POSTED,

RETURNED,

REVERSED

Example:

"PENDING"

posting_date · string<date>

The posting date of the transaction once it gets posted

Example:

"2022-03-18"

transaction_id · string<uuid>

The related transaction id of the transfer.

Example:

"45b5246f-ad97-4629-9aac-465b74a05505"