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

Add/Create a new payment with required payment details.

POST api/Payments/Create

Request Information

URI Parameters

None.

CreatePaymentRequest

Name	Description	Type	Additional information
ClientRef	The Client Reference — a numeric code that uniquely identifies the client. Example: 14356	integer	None.
OperatorID	Unique Operator ID — a numeric code that uniquely identifies the operator. Example: 145	integer	None.
BaseCurrency	The base or settlement currency for the transaction. Example: "EUR"	string	None.
ForeignCurrency	The foreign currency for the transaction. Example: "USD"	string	None.
PayeeID	The unique ID of the beneficiary/payee who will receive funds. Example: 47812345	integer	None.
AmountToBeConverted	Amount to be converted using the quoted FX rate. Example: 123.45	decimal number	None.
AmountTypeForeignOrBase	Indicates whether the amount to convert is Foreign (F) or Base (B). Example: "F"	string	None.
PayeeContact	Optional contact name for the payee. Example: "John Smith"	string	None.
InvoiceComment	Optional note or comment to include with the transaction. Example: "From John Brown"	string	None.
ClientTransactionReference	Optional client transaction reference, often used to pass a merchant name. Example: "Order-12345"	string	None.

Request Formats

application/json, text/json

Sample:

{
ClientRef: 14356,
OperatorID: 89,
BaseCurrency: EUR,
ForeignCurrency: USD,
PayeeID: 546545,
AmountToBeConverted: 1200,
AmountTypeForeignOrBase: B,
PayeeContact: John Smith,
InvoiceComment: From John Brown,
ClientTransactionReference: Merchant Name
}

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">
                  <AmountToBeConverted>1200</AmountToBeConverted>
                  <AmountTypeForeignOrBase>B</AmountTypeForeignOrBase>
                  <BaseCurrency>EUR</BaseCurrency>
                  <ClientRef>14356</ClientRef>
                  <ClientTransactionReference>Merchant Name</ClientTransactionReference>
                  <ForeignCurrency>USD</ForeignCurrency>
                  <InvoiceComment>From John Brown</InvoiceComment>
                  <OperatorID>89</OperatorID>
                  <PayeeContact>John Smith</PayeeContact>
                  <PayeeID>546545</PayeeID>
                </CreatePaymentRequest>

application/x-www-form-urlencoded

Sample:

clientRef=14356
operatorID=145
baseCurrency=EUR
foreignCurrency=USD
payeeID=47812345
amountToBeConverted=123.45
amountTypeForeignOrBase=B
payeeContact=John Smith
invoiceComment=From John Brown
clientTransactionReference=Merchant Name

Response Information

Resource Description

Return unique Transaction Reference (648283)

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.