APIs Home

API Listings

Documentation

Fexco International Payments WEB API is a suite of Restful APIs designed to facilitate a clean flow of payment data

View Global Payment Codes View Product List and Codes View API Code Samples

Streamline & simplify your payment processes with our payable APIs

Or Contact Us

Ireland: 1800 246 800
UK: 0800 840 2887
fipsupport@fexco.com

Return to API Listings

Create a new Payee using POST with Address and Banking Details. On success, returns the new beneficiary unique reference.

POST api/Payee/Create

Request Information

URI Parameters

None.

CreatePayeeRequest

Name	Description	Type	Additional information
ClientID	The Client Reference — a numeric code that uniquely identifies the client. Example: 14356	integer	None.
OperatorID	ID of Operator who is creating the payee Example: 14356	integer	None.
Name	Payee name. Example: 14356	string	None.
ProductID	ID for specific beneficiary product. Example: 58	integer	None.
CurrencyCode	Currency in which money is held in the beneficiary's bank account. Three-digit currency code. Example: CAD	string	None.
BankCountry	ISO 2 alpha Country Code for the payee’s bank country OR ISO 2 numeric Country Code for the payee’s country. Example: 372	string	None.
Email	Payee email Example: ed@gmail.com	string	None.
PayeeAddress1	The first address line of the payee address. Example: Killorglin	string	None.
PayeeCity	The city portion of the payee’s address. Example: Killorglin	string	None.
PayeePostcode	Payee PostCode Example: V93RT45	string	None.
PayeeState	Payee County/State Example: Kerry	string	None.
PayeeCountry	ISO 2 alpha Country Code for the payee’s country OR ISO 2 numeric Country Code for the payee’s country. Example: GB	string	None.
Contact	Payee Contact Name Example: John Doe	string	None.
AccountNumber	Payee Bank Account Number Example: 14356	string	None.
SortCode	Payee Bank Sort Code Example: 14356	string	None.
Bic	Payee BIC Example: MIDLGB22XXX	string	None.
Iban	Payee IBAN Example: GB09MIDL40613503004966	string	None.
BankName	Payee Bank Name Example: Bank Of Ireland	string	None.
BankAddress1	First line of bank address. Example: Killorglin	string	None.
BankCity	Payee Bank City Example: Killorgin	string	None.
BankPostcode	Payee Bank PostCode Example: V93RT56	string	None.
BankState	PAyee Bank County/State Example: Kerry	string	None.
IntermediaryBICCode	Intermediary Bank BIC/SWIFT code. Example: MIDLGB22XXX	string	None.
IntermediaryCountry	ISO 2 alpha Country Code for the payee’s country OR ISO 2 numeric Country Code for the payee’s country. Example: GB	string	None.

Request Formats

application/json, text/json, application/x-www-form-urlencoded

Sample:

clientID=14356
operatorID=145
ame=John Brown
productID=58
npayeeID=47812345
currencyCode=CAD
bankCountry=372
email=johnbrown@fexco.com
payeeAddress1=Killorglin
payeeCity=Killorglin
payeePostcode=V93R5Y2
payeeState=Kerry
payeeCountry=372
contact=John Brown
accountNumber=234324
sortCode=23423
bic=AIGCIE21XXX
iban=GB18LOYD309413000355123
bankName=Bank of Ireland
bankAddress1=Killorglin
bankCity=Killorglin
bankPostcode=V93R45T
bankState=Kerry
intermediaryBICCode=MIDLGB22XXX
intermediaryCountry=GB

application/xml, text/xml

Sample:

<?xml version="1.0" encoding="utf-8"?>
                <CreatePaymentRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BanksApp.Controllers">
                    <clientID>14356</clientID>
                    <operatorID>145</operatorID>
                    <name>John Brown</name>
                    <productID>58</productID>
                    <currencyCode>CAD</currencyCode>
                    <bankCountry>372</bankCountry>
                    <email>johnbrown@fexco.com</email>
                    <payeeAddress1>Killorglin</payeeAddress1>
                    <payeeCity>Killorglin</payeeCity>
                    <payeePostcode>V93R5Y2</payeePostcode>
                    <payeeState>Kerry</payeeState>
                    <payeeCountry>372</payeeCountry>
                    <contact>John Brown</contact>
                    <accountNumber>234324</accountNumber>
                    <sortCode>23423</sortCode>
                    <bic>AIGCIE21XXX</bic>
                    <iban>GB18LOYD309413000355123</iban>
                    <bankName>Bank of Ireland</bankName>
                    <bankAddress1>Killorglin</bankAddress1>
                    <bankCity>Killorglin</bankCity>
                    <bankPostcode>V93R45T</bankPostcode>
                    <bankState>Kerry</bankState>
                    <intermediaryBICCode>MIDLGB22XXX</intermediaryBICCode>
                    <intermediaryCountry>GB</intermediaryCountry>
                    </CreatePayeeRequest>

Response Information

Resource Description

New Unique Payee Reference

integer

Response Formats

application/json, text/json

Sample:

application/xml, text/xml

Sample:

<int xmlns="http://schemas.microsoft.com/2003/10/Serialization/">1</int>

Build your own Payables Solution

Fill in the details above and one of our API experts will contact you to discuss your specific requirements Or

Email us.

Payment solutions experts

As featured in:

Safe, secure & compliant

As a regulated financial institution Fexco International Payments uses robust client asset procedures to keep your funds protected.

In October 2016, Fexco International Payments became the first Irish payments provider to achieve the esteemed ISO 27001 Certification.