Skip to content
APIs/Account Payouts/
/
Additional information

Additional information

Payment Service Provider (PSP) and Money Service Business (MSB) merchants

Additional required details for account payout requests submitted by PSP (Payment Service Provider) or MSB (Money Service Business) merchants:

Note

The requirements apply to all destinations.

API field nameRequired?Field lengthDescription
parties.personalDetails.customerPartyId✅1-35The remitter's payment account number.
Note
If a transfer is not made from a payment account, the payment service provider of the remitter ensures that the transfer of funds is accompanied by a unique transaction identifier rather than the payment account number.
parties.personalDetails.partyTypeCode✅4Type of the party.
Must be:
  • PT01 (Remitter)
parties.personalDetails.typeCode✅4Entity description code for the remitter.
Available values:
  • PD01 (Company)
  • PD02 (Individual)
parties.personalDetails.titleCodeConditional4Title code for the Individual.
Available values:
  • TI01 (Ms)
  • TI02 (Miss)
  • TI03 (Mr)
  • TI04 (Mrs)
  • TI05 (Dr)
  • TI06 (Mx)
  • TI99 (Misc)

Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02 (Individual)
parties.personalDetails.firstNameConditionalMax 50Remitter's first name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02 (Individual)
parties.personalDetails.middleName❌Max 50Remitter's middle name.
parties.personalDetails.lastNameConditionalMax 50Remitter's last name. Full name should be provided (no initials).
Note
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 email corporatesupport@worldpay.com.
Note
Mandatory if parties.personalDetails.typeCode is:
  • PD01 (Company)
  • PD03 (Institution)
  • PD04 (Government)
  • PD99 (Other)
parties.personalDetails.dateofBirth❌12Remitter's date of birth in YYYY-MM-DD format.
parties.address.street✅Max 35Remitter'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 35Remitter'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 35Remitter's city or town of their residential (if remitter is an individual) or registered (if remitter is a company) address.
parties.address.stateConditionalMax 35Remitter's state of their residential (if remitter is an individual) or registered (if remitter is a company) address. Required for countries with a concept of state.
parties.address.postCodeOrZipCode✅Max 10Remitter'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✅2Remitter'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 in your API request.

Countries with a concept of state

Country nameCountry code
AustriaAT
AustraliaAU
BrazilBR
GermanyDE
Micronesia (Federated States of)FM
IndiaIN
MyanmarMM
MexicoMX
MalaysiaMY
NigeriaNG
PalauPW
South SudanSS
United StatesUS

Supported currencies for WIRE payouts with their respective value date cut-off times (UTC).

Submission cut-off (UTC)CurrencyCurrency Code
07:50Hong Kong DollarHKD
08:20Turkish LiraTRY
08:20South African RandZAR
10:50Czech KorunaCZK
10:50 (Mon-Thu)Israeli New ShekelILS
10:50Polish ZlotyPLN
10:50Romanian LeuRON
13:20Danish KronerDKK
13:20Hungarian ForintHUF
13:20Norwegian KronerNOK
13:20New Zealand DollarNZD
13:50Swedish KronerSEK
13:50Thai BahtTHB
14:50Swiss FrancsCHF
14:50EuroEUR
15:15Mexican PesoMXN
15:15Singapore DollarSGD
15:15Australian DollarAUD
15:15Canadian DollarCAD
15:15Pound SterlingGBP
15:15Japanese YenJPY
15:15US DollarsUSD

IBAN and BIC formats by country

This table displays each relevant Country's individual IBAN and BIC format.

KeyDescription
kkCheck digit
bNational bank code or BIC Bank Code (UK, Guernsey, Jersey, Isle of Man)
xNational check digit
cAccount number
sBranch code or sort code (UK, Guernsey, Jersey, Isle of Man)
dAccount type
gGuichet (branch code)
iHolder's kennitala (national identification number - Iceland only)
aBIC bank code
CountrySEPAISO CodeBIC formatIBAN CharactersIBAN FieldsComment
Åland Islands✅AXxxxxAXxx or xxxxAXxxxxx18FIkk bbbb bbcc cccc cx
AlbaniaALxxxxALxx or xxxxALxxxxx28ALkk bbbs sssx cccc cccc cccc cccc
AndorraADxxxxADxx or xxxxADxxxxx24ADkk bbbb ssss cccc cccc cccc
AngolaAOxxxxAOxx or xxxxAOxxxxx25AOkk nnnn nnnn nnnn nnnn nnnn n
Austria✅ATxxxxATxx or xxxxATxxxxx20ATkk bbbb bccc cccc cccc
AzerbaijanAZxxxxAZxx or xxxxAZxxxxx28AZkk bbbb cccc cccc cccc cccc cccc
Azores✅PTxxxxPTxx or xxxxPTxxxxx25PTkk bbbb ssss cccc cccc cccx x
BahrainBHxxxxPTxx or xxxxPTxxxxx22BHkk bbbb cccc cccc cccc cc
Belgium✅BExxxxBHxx or xxxxBHxxxxx16BEkk bbbc cccc ccxx
Bosnia and HerzegovinaBAxxxxBExx or xxxxBExxxxx20BAkk bbbs sscc cccc ccxxkk = 39
BrazilBRxxxxBAxx or xxxxBAxxxxx29BRkk bbbb bbbb ssss sccc cccc cccc ckk = 39
Bulgaria✅BGxxxxBRxx or xxxxBRxxxxx22BGkk bbbb ssss ddcc cccc cc
CameroonCMxxxxBGxx or xxxxBGxxxxx27CMkk nnnn nnnn nnnn nnnn nnnn n
Canary Islands✅ESxxxxESxx or xxxxESxxxxx24ESkk bbbb gggg xxcc cccc cccc
Cape VerdeCVxxxxCVxx or xxxxCVxxxxx25CVkk nnnn nnnn nnnn nnnn nnnn n
Costa RicaCRxxxxCRxx or xxxxCRxxxxx22CRkk bbbb cccc cccc cccc cc
Croatia✅HRxxxxHRxx or xxxxHRxxxxx21HRkk bbbb bbbc cccc cccc c
Cyprus✅CYxxxxCYxx or xxxxCYxxxxx28CYkk bbbs ssss cccc cccc cccc cccc
Czech Republic✅CZxxxxCYxx or xxxxCYxxxxx24CZkk bbbb ssss sscc cccc cccc
Denmark✅DKxxxxDKxx or xxxxDKxxxxx18DKkk bbbb cccc cccc cx
Dominican RepublicDOxxxxDKxx or xxxxDKxxxxx28DOkk bbbb cccc cccc cccc cccc cccc
East TimorTLxxxxTLxx or xxxxTLxxxxx23TLkk bbbc cccc cccc cccc cxx
EgyptEGxxxxEGxx or xxxxEGxxxxx29EGkk bbbb ssss cccc cccc cccc cccc c
Estonia✅EExxxxTLxx or xxxxTLxxxxx20EEkk bbss cccc cccc cccx
Faroe Islands✅FOxxxxFExx or xxxxFExxxxx18FOkk bbbb cccc cccc cx
Finland✅FIxxxxFIxx or xxxxFIxxxxx18FIkk bbbb bbcc cccc cx
France✅FRxxxxFRxx or xxxxFRxxxxx27FRkk bbbb bggg ggcc cccc cccc cxx
French Guiana✅GFxxxxFYxx or xxxxFYxxxxx27GFkk bbbb bggg ggcc cccc cccc cxx
GeorgiaGExxxxFYxx or xxxxFYxxxxx22GEkk bbcc cccc cccc cccc cc
Germany✅DExxxxDExx or xxxxDExxxxx22DEkk bbbb bbbb cccc cccc cc
GibraltarGIxxxxDExx or xxxxDExxxxx23GIkk bbbb cccc cccc cccc ccc
Greece✅GRxxxxDExx or xxxxDExxxxx27GRkk bbbs sssc cccc cccc cccc ccc
Greenland✅GLxxxxDExx or xxxxDExxxxx18GLkk bbbb cccc cccc cx
Guadeloupe✅GPxxxxDExx or xxxxDExxxxx27GPkk bbbb bggg ggcc cccc cccc cxx
GuatemalaGTxxxxDExx or xxxxDExxxxx28GTkk bbbb mmtt cccc cccc cccc cccc
Hungary✅HUxxxxDExx or xxxxDExxxxx28HUkk bbbb bbss cccc cccc cccc cccx
Iceland✅ISxxxxDExx or xxxxDExxxxx26ISkk bbbb sscc cccc cccc cccx xx
Ireland✅IExxxxDExx or xxxxDExxxxx22IEkk bbbb ssss sscc cccc cc
Isle of Man✅IMxxxxDExx or xxxxDExxxxx22IMkk bbbs ssss sscc cccc cc
IsraelILxxxxDExx or xxxxDExxxxx23ILkk bbbs sscc cccc cccc ccc
Italy✅ITxxxxDExx or xxxxDExxxxx27ITkk xbbb bbss sscc cccc cccc ccc
Ivory CoastCIxxxxDExx or xxxxDExxxxx28CIkk bbcc cccc cccc cccc cccc cccc
JordanJOxxxxDExx or xxxxDExxxxx30JOkk bbbb nnnn cccc cccc cccc cccc cc
KosovoXKxxxxDExx or xxxxDExxxxx20XKkk bbbb cccc cccc cccc
Latvia✅LVxxxxDExx or xxxxDExxxxx21LVkk bbbb cccc cccc cccc c
LebanonLBxxxxDExx or xxxxDExxxxx28LBkk bbcc cccc cccc cccc cccc cccc
Liechtenstein✅LIxxxxDExx or xxxxDExxxxx21LIkk bbbb bccc cccc cccc c
Lithuania✅LTxxxxDExx or xxxxDExxxxx20LTkk bbbb bccc cccc cccc
Luxembourg✅LUxxxxDExx or xxxxDExxxxx20LUkk bbbc cccc cccc cccc
MadagascarMGxxxxDExx or xxxxDExxxxx27MGkk bbbb bsss sccc cccc cccc ccc
Madeira✅PTxxxxDExx or xxxxDExxxxx25PTkk bbbb ssss cccc cccc cccx x
Malta✅MTxxxxDExx or xxxxDExxxxx31MTkk bbbb ssss sccc cccc cccc cccc ccc
Martinique✅MQxxxxDExx or xxxxDExxxxx27MQkk bbbb bggg ggcc cccc cccc cxx
MauritaniaMRxxxxDExx or xxxxDExxxxx27MRkk bbss ssss sccc cccc cccc ccc
MauritiusMUxxxxDExx or xxxxDExxxxx30MUkk bbbb bbss cccc cccc cccc 000d dd
Mayotte✅YTxxxxDExx or xxxxDExxxxx27YTkk bbbb bggg ggcc cccc cccc cxx
MoldovaMDxxxxDExx or xxxxDExxxxx24MDkk bbcc cccc cccc cccc cccc
MonacoMCxxxxDExx or xxxxDExxxxx27MCkk bbbb bsss sscc cccc cccc cxx
MontenegroMExxxxDExx or xxxxDExxxxx22MEkk bbcc cccc cccc cccc xx
MoroccoMAxxxxDExx or xxxxDExxxxx28MAkk bbcc cccc cccc cccc cccc cccc
Netherlands✅NLxxxxDExx or xxxxDExxxxx18NLkk bbbb cccc cccc cc
New Caledonia✅NCxxxxDExx or xxxxDExxxxx27NCkk bbbb bggg ggcc cccc cccc cxx
North MacedoniaMKxxxxDExx or xxxxDExxxxx19MKkk bbcc cccc cccc cxx
Norway✅NOxxxxDExx or xxxxDExxxxx15NOkk bbbb cccc ccc
PalestinePSxxxxDExx or xxxxDExxxxx29PSkk bbbb xxxx xxxx xccc cccc cccc c
Poland✅PLxxxxDExx or xxxxDExxxxx28PLkk bbbs sssc cccc cccc cccc cccx
Portugal✅PTxxxxDExx or xxxxDExxxxx25PTkk bbbb ssss cccc cccc cccx x
QatarQAxxxxDExx or xxxxDExxxxx29QAkk bbbb cccc cccc cccc cccc cccc x
Réunion✅RExxxxDExx or xxxxDExxxxx27REkk bbbb bggg ggcc cccc cccc cxx
Romania✅ROxxxxDExx or xxxxDExxxxx24ROkk bbbb cccc cccc cccc cccc
Saint Barthélemy✅BLxxxxDExx or xxxxDExxxxx27BLkk bbbb bggg ggcc cccc cccc cxx
Saint Martin✅MFxxxxDExx or xxxxDExxxxx27MFkk bbbb bggg ggcc cccc cccc cxx
Saint Pierre and Miquelon✅PMxxxxDExx or xxxxDExxxxx27PMkk bbbb bggg ggcc cccc cccc cxx
San MarinoSMxxxxDExx or xxxxDExxxxx27SMkk xbbb bbss sccc cccc cccc ccc
Sao Tome and PrincipeSTxxxxDExx or xxxxDExxxxx25STkk bbbb sssc cccc cccc cccc c
Saudi ArabiaSAxxxxDExx or xxxxDExxxxx24SAkk bbcc cccc cccc cccc cccc
SenegalSNxxxxDExx or xxxxDExxxxx28SNkk bbss sccc cccc cccc cccc cccc
SerbiaRSxxxxDExx or xxxxDExxxxx22RSkk bbcc cccc cccc cccc xx
Slovakia✅SKxxxxDExx or xxxxDExxxxx24SKkk bbbb ssss sscc cccc cccc
Slovenia✅SIxxxxDExx or xxxxDExxxxx19SIkk bbss sccc cccc cxx
Spain✅ESxxxxDExx or xxxxDExxxxx24ESkk bbbb gggg xxcc cccc cccc
Sweden✅SExxxxDExx or xxxxDExxxxx24SEkk bbbc cccc cccc cccc cccc
Switzerland✅CHxxxxDExx or xxxxDExxxxx21CHkk bbbb bccc cccc cccc c
TunisiaTNxxxxDExx or xxxxDExxxxx24TNkk bbss sccc cccc cccc cccc
TurkeyTRxxxxDExx or xxxxDExxxxx26TRkk bbbb bxcc cccc cccc cccc cc
UkraineUAxxxxDExx or xxxxDExxxxx29UAkk bbbb bccc cccc cccc cccc cccc x
United Arab EmiratesAExxxxDExx or xxxxDExxxxx23AEkk bbcc cccc cccc cccc ccc
United Kingdom✅GBxxxxDExx or xxxxDExxxxx22GBkk bbbb ssss sscc cccc cc

Purpose of payment - list of accepted codes

Not applicable for UAE payments - please refer to UAE guide for UAE purpose of payments codes.

purposeOfPaymentCodeWorldpay by FIS - Description
WPPAYRPayment of payroll
WPPENSPension payment
WPFAMTFamily maintenance
WPUBILPayment to common utility provider
WPSTDYPayment of study/tuition costs
WPTAXSPayment of taxes
WPGDDSPurchase sale of goods
WPCHARPayment for charity reasons
WPMDCSPayment for medical care services
WPSAVSPayment to savings/retirement account
WPPROPPayment of property purchase
WPSCVEPurchase sale of services
WPSHARPayment of shares
WPIVSTPayment of an investment (interest)
WPTKAGTourism (Invoiced Tickets/Travel Agency costs)
WPTOURTourism (other)
WPREMTRemittances
WPMOVRPayment of movable property rental
WPSUPPSupplier payment
WPCAPIPayment of capital contribution
WPCHRGCharges/ Fees
WPTRANPayment for transportation
WPSALRPayment of salaries
WPDIVDDividends
WPLOANLoans
WPISERPayment of insurance services
WPFSERPayment for financial services
WPCARDCard payments
WPRENTRental Payments
WPEXPEPayment of expenses
WPTRNFTransfer of funds
WPBONSBonus/compensation
WPOTHROther