Canada
Domestic Payment
Overview
Available | Yes |
targetCurrency | Canadian Dollar (CAD) |
countryCode | CA |
Earliest Beneficiary Credit | T+1 |
Cut-Off Time (UK Time) | 15:30 |
Decimal Places | 2 |
Minimum targetAmount | 0.01 |
Maximum targetAmount | 9999999.99 (The Maximum amount of 10000.00 CAD applies for specific payment types. Please contact your Relationship Manager to verify.) |
Submission data
API field name | Required? | Field length | Description |
---|---|---|---|
bankDetails.beneficiaryAccountNumber | ✅ | 5-12 | Account 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.bankCode | ✅ | 3 | Identifies 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.branchCode | ✅ | 5 | Uniquely 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.bankName | ✅ | Max 35 | Name of the beneficiary bank. |
parties.personalDetails.partyTypeCode | ✅ | 4 | Type of the party. Must be:
|
parties.personalDetails.typeCode | ✅ | 4 | Entity description code for the party. Available values:
|
parties.personalDetails.titleCode | Conditional | 4 | Title code for the Individual. Available values:
Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.firstName | Conditional | 2-50 | Beneficiary first name. Full name should be provided (no initials). Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.middleName | ❌ | Max 50 | Beneficiary middle name. |
parties.personalDetails.lastName | Conditional | Max 50 | Beneficiary last name. Full name should be provided (no initials). Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.companyName | Conditional | Max 140 | Full 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:
|
parties.personalDetails.dateOfBirth | ❌ | 10 | Beneficiary's date of birth in YYYY-MM-DD format. |
parties.address.street | ✅ | 2-35 | Beneficiary'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.additionalAddressLine | ❌ | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio. |
parties.address.city | ✅ | 2-35 | Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address. |
parties.address.state | ✅ | 2-35 | Beneficiary's full state name of their residential (if payee is an individual) or registered (if payee is a company) address. |
parties.address.postcodeOrZipCode | ✅ | 2-10 | Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address. |
parties.address.countryCode | ✅ | 2 | Beneficiary'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
Available | Yes |
targetCurrency | Available WIRE currencies |
countryCode | CA |
Earliest Beneficiary Credit | The estimated delivery time will vary by country and currency. |
Cut-Off Time (UK Time) | Currency specific |
Decimal Places | 2 |
Minimum targetAmount | 0.01 |
Maximum targetAmount | 9999999.99 |
Submission data
API field name | Required? | Field length | Description |
---|---|---|---|
bankDetails.beneficiaryAccountNumber | ✅ | 5-12 | Account 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.swiftBic | ✅ | 8 or 11 | The SWIFT BIC is the Bank Identification Code of the beneficiary bank. |
bankDetails.bankCode | ✅ | 3 | Identifies 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.branchCode | ✅ | 5 | Uniquely 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.bankName | ✅ | Max 35 | Name of the beneficiary bank. |
parties.personalDetails.partyTypeCode | ✅ | 4 | Type of the party. Must be:
|
parties.personalDetails.typeCode | ✅ | 4 | Entity description code for the party. Available values:
|
parties.personalDetails.titleCode | Conditional | 4 | Title code for the Individual. Available values:
Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.firstName | Conditional | Max 50 | Beneficiary first name. Full name should be provided (no initials). Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.middleName | ❌ | Max 50 | Beneficiary middle name. |
parties.personalDetails.lastName | Conditional | Max 50 | Beneficiary last name. Full name should be provided (no initials). Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.companyName | Conditional | Max 140 | Full 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:
|
parties.personalDetails.dateOfBirth | ❌ | 10 | Beneficiary's date of birth in YYYY-MM-DD format. |
parties.address.street | ✅ | Max 35 | Beneficiary'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.additionalAddressLine | ❌ | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio. |
parties.address.city | ✅ | Max 35 | Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address. |
parties.address.state | ✅ | Max 30 | Beneficiary's full state name of their residential (if payee is an individual) or registered (if payee is a company) address. |
parties.address.postcodeOrZipCode | ✅ | Max 10 | Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address. |
parties.address.countryCode | ✅ | 2 | Beneficiary'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).