Canada

Domestic Payment

Overview

AvailableYes
targetCurrencyCanadian Dollar (CAD)
countryCodeCA
Earliest Beneficiary CreditT+1
Cut-Off Time (UK Time)15:30
Decimal Places2
Minimum targetAmount0.01
Maximum targetAmount9999999.99 (The Maximum amount of 10000.00 CAD applies for specific payment types. Please contact your Relationship Manager to verify.)

Submission data

API field nameRequired?Field lengthDescription
bankDetails.beneficiaryAccountNumber5-12Account number of the beneficiary. Can be between 5 and 12 digits, but is usually greater than 7 digits in length.
On most bank cheques, the account number is after the Branch Transit and Financial Institution numbers.
bankDetails.bankCode3Identifies the beneficiary's Canadian Bank.
This is always 3 digits in length, and can be found on the beneficiary's online banking or a cheque. Most online banking portals allow you to create a void cheque through the interface.
See Additonal Information below.
bankDetails.branchCode5Uniquely identifies the beneficiary's Canadian Bank branch.
This can be found on the beneficiary's online banking or a cheque. A void cheque can be created through most online banking portals.
See Additonal Information below.
bankDetails.bankNameMax 35Name of the beneficiary bank.
parties.personalDetails.partyTypeCode4Type of the party.
Must be:
  • PT03 (Beneficiary)
parties.personalDetails.typeCode4Entity description code for the party.
Available values:
  • PD01 (Company)
  • PD02 (Individual)
parties.personalDetails.titleCodeConditional4Title code for the Individual.
Available values:
  • TO01 (Ms)
  • TO02 (Miss)
  • TO03 (Mr)
  • TO04 (Mrs)
  • TO05 (Dr)
  • TO06 (Mx)
  • TO99 (Misc)
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02 (Individual)
parties.personalDetails.firstNameConditional2-50Beneficiary first name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02 (Individual)
parties.personalDetails.middleNameMax 50Beneficiary middle name.
parties.personalDetails.lastNameConditionalMax 50Beneficiary last name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02 (Individual)
parties.personalDetails.companyNameConditionalMax 140Full name of the organization.
Warning
Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space. To whitelist any other naming format please contact your Relationship Manager.
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD01 (Company)
  • PD03 (Institution)
  • PD04 (Government)
  • PD99 (Other)
parties.personalDetails.dateOfBirth10Beneficiary's date of birth in YYYY-MM-DD format.
parties.address.street2-35Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street.
parties.address.additionalAddressLineMax 35Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio.
parties.address.city2-35Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.state2-35Beneficiary's full state name of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.postcodeOrZipCode2-10Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.countryCode2Beneficiary's country code of their residential (if payee is an individual) or registered (if payee is a company) address.
Enter the 2 character ISO 3166-1 standard country code in your API request.
Important

Additional data is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB).

Additional Information

A beneficiary's Branch Transit Number and Financial Institution Number is sometimes combined into a Routing Number.

The Routing Number format is 0XXXYYYYY, and this consists of:

  • 0 - Leading zero. Do not include in Push to Account instruction
  • XXX - Financial Institution Number
  • YYYYY - Branch Transit Number
Note

A full list of Canadian Bank Routing Numbers can be found here.

International WIRE

Overview

AvailableYes
targetCurrencyAvailable WIRE currencies
countryCodeCA
Earliest Beneficiary CreditThe estimated delivery time will vary by country and currency.
Cut-Off Time (UK Time)Currency specific
Decimal Places2
Minimum targetAmount0.01
Maximum targetAmount9999999.99

Submission data

API field nameRequired?Field lengthDescription
bankDetails.beneficiaryAccountNumber5-12Account number of the beneficiary. Can be between 5 and 12 digits, but is usually greater than 7 digits in length.
On most bank cheques, the account number is after the Branch Transit and Financial Institution numbers.
bankDetails.swiftBic8 or 11The SWIFT BIC is the Bank Identification Code of the beneficiary bank.
bankDetails.bankCode3Identifies the beneficiary's Canadian Bank.
This is always 3 digits in length, and can be found on the beneficiary's online banking or a cheque. Most online banking portals allow you to create a void cheque through the interface.
See Additonal Information below.
bankDetails.branchCode5Uniquely identifies the beneficiary's Canadian Bank branch.
This can be found on the beneficiary's online banking or a cheque. A void cheque can be created through most online banking portals.
See Additonal Information below.
bankDetails.bankNameMax 35Name of the beneficiary bank.
parties.personalDetails.partyTypeCode4Type of the party.
Must be:
  • PT03 (Beneficiary)
parties.personalDetails.typeCode4Entity description code for the party.
Available values:
  • PD01 (Company)
  • PD02 (Individual)
parties.personalDetails.titleCodeConditional4Title code for the Individual.
Available values:
  • TO01 (Ms)
  • TO02 (Miss)
  • TO03 (Mr)
  • TO04 (Mrs)
  • TO05 (Dr)
  • TO06 (Mx)
  • TO99 (Misc)
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02 (Individual)
parties.personalDetails.firstNameConditionalMax 50Beneficiary first name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02 (Individual)
parties.personalDetails.middleNameMax 50Beneficiary middle name.
parties.personalDetails.lastNameConditionalMax 50Beneficiary last name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02 (Individual)
parties.personalDetails.companyNameConditionalMax 140Full name of the organization.
Important
Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space. To whitelist any other naming format please contact your Relationship Manager.
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD01 (Company)
  • PD03 (Institution)
  • PD04 (Government)
  • PD99 (Other)
parties.personalDetails.dateOfBirth10Beneficiary's date of birth in YYYY-MM-DD format.
parties.address.streetMax 35Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street.
parties.address.additionalAddressLineMax 35Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio.
parties.address.cityMax 35Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.stateMax 30Beneficiary's full state name of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.postcodeOrZipCodeMax 10Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.countryCode2Beneficiary's country code of their residential (if payee is an individual) or registered (if payee is a company) address.
Enter the 2 character ISO 3166-1 standard country code in your API request.
Important

Additional data is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB).