# Taiwan

## Domestic wire payment

### Overview

table
tr
td
Available
td
Yes
tr
td
code
targetCurrency
td
New Taiwan Dollar (TWD)
tr
td
code
countryCode
td
TW
tr
td
Earliest Beneficiary Credit
td
T+5
tr
td
Cut-Off Time (UK Time)
td
15:30
tr
td
Decimal Places
td
2
tr
td
Minimum 
code
targetAmount
td
Equivalent of 25.00 USD
tr
td
Maximum 
code
targetAmount
td
500000.00
### Submission data

| API field name | Required? | Field length | Description |
|  --- | --- | --- | --- |
| `purposeOfPaymentNarrative` | ✅ | Max 35 | Description for purpose of payment. |
| `bankDetails.beneficiaryAccountNumber` | ✅ | Max 34 | Account number of the beneficiary. |
| `bankDetails.swiftBic` | ✅ | 8 or 11 | The SWIFT BIC is the Bank Identification Code of the beneficiary bank. |
| `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` | Strongly recommended | 10 | Beneficiary's date of birth in YYYY-MM-DD format. |
| `parties.personalDetails.email` | Strongly recommended | Max 50 | Beneficiary's email address. |
| `parties.personalDetails.telephony.phoneNumber` | ✅ | 5-15 | Beneficiary's phone number. |
| `parties.personalDetails.telephony.prefix` | ✅ | 1-3 | Beneficiary's phone number prefix. |
| `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.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. **Must be**:`TW (The Beneficiary and their bank must be in Taiwan.)` |


### Additional data for payments to Taiwan

Important
[Additional data](/access/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). As an additional requirement for payments to Taiwan please provide the the remitters's payment account number or identification in the Remitter's Identity section as per the below table.

| API field name | Required? | Field length | Description |
|  --- | --- | --- | --- |
| `parties.personalDetails.partyTypeCode` | ✅ | 4 | Type of the party.**Must be**:`PT01 (Remitter)` |
| `parties.personalDetails.typeCode` | ✅ | 4 | Entity description code for the remitter.**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 | Remitter first name. Full name should be provided (no initials).  Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.middleName` | ❌ | Max 50 | Remitter middle name. |
| `parties.personalDetails.lastName` | Conditional | Max 50 | Remitter 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` | Strongly recommended | 10 | Remitter's date of birth in YYYY-MM-DD format. |
| `parties.personalDetails.email` | Strongly recommended | Max 50 | Remitter's email address |
| `parties.personalDetails.telephony.phoneNumber` | Strongly recommended | 5-20 | Phone number of the remitter. |
| `parties.personalDetails.telephony.prefix` | Strongly recommended | 1-3 | Phone dialing country code of the remitter. |
| `parties.identity.identityTypeCode` | ✅ | 4 | Remitter's identity type.**Available values**:`ID01 (Passport)``ID02 (National ID)``ID03 (Driver Licence)``ID04 (Work Permit)``ID05 (Employment Pass)``ID06 (Student Pass)``ID07 (Permanent Resident Card)``ID09 (Company Registration Number)``ID10 (Company VAT Number)``ID11 (Citizenship Card)``ID12 (Tax ID)``ID13 (National Insurance)``ID15 (Legal Identity Card)``ID16 (Tax Registration Code)``ID99 (Other)` |
| `parties.identity.identityNumber` | ✅ | 11 | Remitter's identity number. The remitters's payment account number.  In the case of a transfer not made from a payment account, the payment service provider of the remitter shall ensure that the transfer of funds is accompanied by a unique transaction identifier rather than the payment account number  |
| `parties.identity.issuingCountry` | ✅ | 2 | Remitter's country code of their identification document.Enter the [2 character ISO 3166-1 standard country code](/access/products/reference/supported-countries-currencies#iso-country-codes) in your API request. |
| `parties.address.street` | ✅ | Max 35 | Remitter's residential (if remitter is an individual) or registered (if remitter is a company) house number/name and street e.g. 1 Main Street. |
| `parties.address.additionalAddressLine` | ✅ | Max 35 | Remitter's residential (if remitter is an individual) or registered (if remitter is a company) address e.g. apartment no., unit, studio. |
| `parties.address.city` | ✅ | Max 35 | Remitter's city or town of their residential (if remitter is an individual) or registered (if remitter is a company) address. |
| `parties.address.postCodeOrZipCode` | ✅ | Max 10 | Remitter's postal code or zip code of their residential (if remitter is an individual) or registered (if remitter is a company) address. |
| `parties.address.countryCode` | ✅ | 2 | Remitter's country code of their residential (if remitter is an individual) or registered (if remitter is a company) address.Enter the [2 character ISO 3166-1 standard country code](/access/products/reference/supported-countries-currencies#iso-country-codes) in your API request. |


## International WIRE

### Overview

table
tr
td
Available
td
Yes
tr
td
code
targetCurrency
td
a
Available WIRE currencies
tr
td
code
countryCode
td
TW
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 |
|  --- | --- | --- | --- |
| `purposeOfPaymentNarrative` | ✅ | Max 35 | Description for purpose of payment. |
| `bankDetails.beneficiaryAccountNumber` | ✅ | Max 34 | Account number of the beneficiary. |
| `bankDetails.bankCode` | ✅ | 3 | Bank code of the beneficiary (bank). |
| `bankDetails.branchCode` | ✅ | 4 | Wire Transfer Branch Code of the beneficiary (bank). |
| `bankDetails.swiftBic` | ✅ | 8 or 11 | The SWIFT BIC is the Bank Identification Code of the beneficiary bank. |
| `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` | Strongly recommended | 10 | Beneficiary's date of birth in YYYY-MM-DD format. |
| `parties.personalDetails.email` | Strongly recommended | Max 50 | Beneficiary's email address. |
| `parties.personalDetails.telephony.phoneNumber` | Strongly recommended | 5-20 | Phone number of the beneficiary. |
| `parties.personalDetails.telephony.prefix` | Strongly recommended | 1-3 | Phone dialing country code of the beneficiary. |
| `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](/access/products/reference/supported-countries-currencies#iso-country-codes) in your API request. |


Important
[Additional data](/access/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).