# Canada

## Domestic Payment (Interac)

### Overview

table
tr
td
Available
td
Yes
tr
td
code
targetCurrency
td
Canadian Dollar (CAD)
tr
td
code
countryCode
td
CA
tr
td
Earliest Beneficiary Credit
td
real-time (
i
can take up to 30 minutes
)
tr
td
Cut-Off Time (UK Time)
td
N/A
tr
td
Decimal Places
td
2
tr
td
Minimum 
code
targetAmount
td
0.01
tr
td
Maximum 
code
targetAmount
td
10000.00
### 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 [Additional Information](/products/account-payouts/v2/coverage/additionalinfo) 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 [Additional Information](/products/account-payouts/v2/coverage/additionalinfo) below. |
| `bankDetails.bankName` | ✅ | Max 35 | Name of the beneficiary bank. |
| `parties.personalDetails.partyTypeCode` | ✅ | 4 | Type of the party. **Must be**:`PT03 (Beneficiary)` |
| `parties.personalDetails.typeCode` | ✅ | 4 | Entity description code for the party.**Available values:**`PD01 (Company)``PD02 (Individual)``PD99 (Other)` |
| `parties.personalDetails.titleCode` | Conditional | 4 | Title code for the Individual.**Available values**:`TI01 (Ms)``TI02 (Miss)``TI03 (Mr)``TI04 (Mrs)``TI05 (Dr)``TI06 (Mx)``TI99 (Misc)`  Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.firstName` | Conditional | 2-50 | Beneficiary first name. Full name should be provided (no initials). Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.middleName` | ❌ | Max 50 | Beneficiary middle name. |
| `parties.personalDetails.lastName` | Conditional | Max 50 | Beneficiary last name. Full name should be provided (no initials). Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.companyName` | Conditional | Max 140 | Full name of the organization.  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.   Mandatory if `parties.personalDetails.typeCode` is:`PD01 (Company)``PD03 (Institution)``PD04 (Government)``PD99 (Other)`  |
| `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](http://www.iso.org/iso/country_codes) in your API request. |


Important
[Additional data](/products/account-payouts/v2/coverage/additionalinfo) is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB).

## Domestic Payment

### Overview

table
tr
td
Available
td
Yes
tr
td
code
targetCurrency
td
Canadian Dollar (CAD)
tr
td
code
countryCode
td
CA
tr
td
Earliest Beneficiary Credit
td
T+1
tr
td
Cut-Off Time (UK Time)
td
15:00
tr
td
Decimal Places
td
2
tr
td
Minimum 
code
targetAmount
td
0.01
tr
td
Maximum 
code
targetAmount
td
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 [Additional Information](/products/account-payouts/v2/coverage/additionalinfo) 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 [Additional Information](/products/account-payouts/v2/coverage/additionalinfo) below. |
| `bankDetails.bankName` | ✅ | Max 35 | Name of the beneficiary bank. |
| `parties.personalDetails.partyTypeCode` | ✅ | 4 | Type of the party. **Must be**:`PT03 (Beneficiary)` |
| `parties.personalDetails.typeCode` | ✅ | 4 | Entity description code for the party.**Available values:**`PD01 (Company)``PD02 (Individual)``PD99 (Other)` |
| `parties.personalDetails.titleCode` | Conditional | 4 | Title code for the Individual.**Available values**:`TI01 (Ms)``TI02 (Miss)``TI03 (Mr)``TI04 (Mrs)``TI05 (Dr)``TI06 (Mx)``TI99 (Misc)`  Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.firstName` | Conditional | 2-50 | Beneficiary first name. Full name should be provided (no initials). Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.middleName` | ❌ | Max 50 | Beneficiary middle name. |
| `parties.personalDetails.lastName` | Conditional | Max 50 | Beneficiary last name. Full name should be provided (no initials). Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.companyName` | Conditional | Max 140 | Full name of the organization.  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.   Mandatory if `parties.personalDetails.typeCode` is:`PD01 (Company)``PD03 (Institution)``PD04 (Government)``PD99 (Other)`  |
| `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](/products/reference/supported-countries-currencies#iso-country-codes) in your API request. |


Important
[Additional data](/products/account-payouts/v2/coverage/additionalinfo) 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](https://www.payments.ca/sites/default/files/18-Oct-18/mbrbnksn_3.pdf).

## Domestic Payment (USD)

### Overview

table
tr
td
Available
td
Yes
tr
td
code
targetCurrency
td
United States Dollar (USD)
tr
td
code
countryCode
td
CA
tr
td
Earliest Beneficiary Credit
td
T+1
tr
td
Cut-Off Time (UK Time)
td
15:00
tr
td
Decimal Places
td
2
tr
td
Minimum 
code
targetAmount
td
0.01
tr
td
Maximum 
code
targetAmount
td
9999999.99
Important
USD ACH is only available for merchants that are on-boarded on the **Worldpay Canada Corporation** entity.

### 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 [Additional Information](/products/account-payouts/v2/coverage/additionalinfo) 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 [Additional Information](/products/account-payouts/v2/coverage/additionalinfo) below. |
| `bankDetails.bankName` | ✅ | Max 35 | Name of the beneficiary bank. |
| `parties.personalDetails.partyTypeCode` | ✅ | 4 | Type of the party. **Must be**:`PT03 (Beneficiary)` |
| `parties.personalDetails.typeCode` | ✅ | 4 | Entity description code for the party.**Available values:**`PD01 (Company)``PD02 (Individual)``PD99 (Other)` |
| `parties.personalDetails.titleCode` | Conditional | 4 | Title code for the Individual.**Available values**:`TI01 (Ms)``TI02 (Miss)``TI03 (Mr)``TI04 (Mrs)``TI05 (Dr)``TI06 (Mx)``TI99 (Misc)`  Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.firstName` | Conditional | 2-50 | Beneficiary first name. Full name should be provided (no initials). Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.middleName` | ❌ | Max 50 | Beneficiary middle name. |
| `parties.personalDetails.lastName` | Conditional | Max 50 | Beneficiary last name. Full name should be provided (no initials). Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.companyName` | Conditional | Max 140 | Full name of the organization.  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.   Mandatory if `parties.personalDetails.typeCode` is:`PD01 (Company)``PD03 (Institution)``PD04 (Government)``PD99 (Other)`  |
| `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](/products/reference/supported-countries-currencies#iso-country-codes) in your API request. |


Important
[Additional data](/products/account-payouts/v2/coverage/additionalinfo) 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](https://www.payments.ca/sites/default/files/18-Oct-18/mbrbnksn_3.pdf).

## International WIRE

### Overview

table
tr
td
Available
td
Yes
tr
td
code
targetCurrency
td
a
Available WIRE currencies
tr
td
code
countryCode
td
CA
tr
td
Earliest Beneficiary Credit
td
The estimated delivery time will vary by country and currency.
tr
td
Cut-Off Time (UK Time)
td
a
Currency specific
tr
td
Decimal Places
td
2
tr
td
Minimum 
code
targetAmount
td
0.01
tr
td
Maximum 
code
targetAmount
td
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 [Additional Information](/products/account-payouts/v2/coverage/additionalinfo) 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 [Additional Information](/products/account-payouts/v2/coverage/additionalinfo) below. |
| `bankDetails.bankName` | ✅ | Max 35 | Name of the beneficiary bank. |
| `parties.personalDetails.partyTypeCode` | ✅ | 4 | Type of the party.**Must be**:`PT03 (Beneficiary)` |
| `parties.personalDetails.typeCode` | ✅ | 4 | Entity description code for the party.**Available values:**`PD01 (Company)``PD02 (Individual)` |
| `parties.personalDetails.titleCode` | Conditional | 4 | Title code for the Individual.**Available values**:`TI01 (Ms)``TI02 (Miss)``TI03 (Mr)``TI04 (Mrs)``TI05 (Dr)``TI06 (Mx)``TI99 (Misc)`  Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.firstName` | Conditional | Max 50 | Beneficiary first name. Full name should be provided (no initials). Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.middleName` | ❌ | Max 50 | Beneficiary middle name. |
| `parties.personalDetails.lastName` | Conditional | Max 50 | Beneficiary last name. Full name should be provided (no initials). Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.companyName` | Conditional | Max 140 | Full name of the organization.  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.  Mandatory if `parties.personalDetails.typeCode` is:`PD01 (Company)``PD03 (Institution)``PD04 (Government)``PD99 (Other)`  |
| `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](/products/reference/supported-countries-currencies#iso-country-codes) in your API request. |


Important
[Additional data](/products/account-payouts/v2/coverage/additionalinfo) is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB).