Originate an Interac e-Transfer
How to originate an Interac e-Transfer
An Interac e-Transfer, also known as Bulk Interac e-Transfers, is represented as a new payment type in Modern Treasury called interac
.
To originate an Interac e-Transfer, set the payment_type
to interac
and direction
to credit
. Unlike most payment types, Interac payments rely on the recipient's email address and/or phone number associated with the receiving account.
Contact Details
To originate an Interac e-Transfer, either an email address or phone number must be provided. The relevant contact details can be provided in a number of ways.
Payment Order creation
The contact details can be provided in-line, when creating a Payment Order similar to account and routing details.
Note that either an email or phone number is required for Interac payments. The examples show both for completeness. If both are provided, both must be associated with the recipient's account within the Interac system.
{
"type": "interac",
"direction": "credit",
"receiving_account": {
"party_name": "Harry Potter",
"contact_details": [
{
"contact_identifier": "[email protected]",
"contact_identifier_type": "email"
},
{
"contact_identifier": "1234567890",
"contact_identifier_type": "phone_number"
}
]
}
}
External Account or Counterparty creation
Contact details can also be provided when creating the External account, either directly or when creating a Counterparty.
{
"party_name": "Harry Potter",
"counterparty_id": "<Counterparty ID>",
"contact_details": [
{
"contact_identifier": "[email protected]",
"contact_identifier_type": "email"
},
{
"contact_identifier": "1234567890",
"contact_identifier_type": "phone_number"
}
]
}
{
"name": "Harry Potter",
"accounts": [
{
"account_type": "checking",
"party_name": "Harry Potter",
"routing_details": [
{
"routing_number_type": "aba",
"routing_number": "026009593"
}
],
"account_details": [
{
"account_number": "123456789"
}
],
"contact_details": [
{
"contact_identifier": "[email protected]",
"contact_identifier_type": "email"
},
{
"contact_identifier": "1234567890",
"contact_identifier_type": "phone_number"
}
]
}
]
}
If a counterparty_id
is provided when creating an External Account and contact_details
are omitted, the Counterparty's email
will be copied down to the External Account as a contact detail.
Detailed Examples
See Payment Order Examples for an example Interac e-Transfer.
See Contact Details for details on the contact details API.
Updated 12 months ago