International payments
The information that is required for an international payment.
A payment is considered as an international transfer if:
-
It is to be made to a country that is not covered by either the SEPA or domestic payment service described elsewhere in this guide
-
The currency of the recipient’s bank account (the target currency) is not local to the receiving country – sending US Dollars to France for instance
All fields are required unless otherwise indicated.
If the account number is used it should be submitted in the Worldpay AP accountNumber
parameter. If the IBAN is used it should be submitted in the Worldpay AP Iban
parameter.
At least one of these identifiers is required.
Field name |
API field name |
Length |
Comments |
---|---|---|---|
Bank name |
bankName |
50 |
The name of the bank where the recipient holds their account. |
Branch location |
branchAddress |
50 |
Optional: General location is acceptable (for example, Norwich). |
Payee |
Payee |
35 |
The name of the recipient as specified on the bank account. |
Account number |
accountNumber |
50 |
Conditional: See note above. The recipient’s account number or IBAN. |
Bank code |
bankCode |
50 |
Optional: The bank code of the recipient bank. |
Branch code |
branchCode |
50 |
Optional: The branch code of the recipient bank. Gather if possible to do so. |
IBAN |
Iban |
50 |
Conditional: See Tip above. The IBAN of the recipient bank account. Gather if possible to do so (not all countries utilise the IBAN format for a bank account structure). |
SWIFT BIC |
Swift |
8/11 |
The SWIFT (BIC) code of the recipient bank. Can usually be found on the bank statement the recipient bank. |