×
Menu

Barclays EPDQ (DirectLink) Payment Gateway

 
This page details the inputs, secure inputs and outputs available for the DirectLink Barclays EPDQ (DirectLink) Logic Item, how to complete each field.
 
PCI Pal must check any payment gateway integrations prior to going live.  The documentation disclaimer (which applies throughout this guide) should be read before commencing any configuration of payment gateways.
 

Inputs

Input Fields
Required
Character Limits/Required Input
Description
pspId
Yes
30 AN
Unique client ID given by the DirectLink gateway
userId
Yes
20 AN
API User name given to the client by the DirectLink gateway
pswd
Yes
n/a
Password that corresponds to the userid
shaPassphrase
Yes
n/a
The State
operation
Yes
3 Char
The Transaction Type, can be any of the following:
- RES: Authorization request
- SAL: Direct Sale request
- RFD: Refund request
- PAU - Pre-Auth request
amount
Yes
n/a
Currency of the transaction
cn
No
35 AN
Customer name
orderId
Yes
40 AN
The unique order number (merchant reference)
currency
Yes
3 AN
ISO alpha order currency code, for example: EUR, USD, GBP, CHF, etc
com
No
100 AN
Order description
email
No
50 AN
Customer’s telephone number
ownerAddress
No
50 AN
Customer’s street name and number
ownerCity
No
2 AN
Customer’s country, e.g. BE, NL, FR, etc
ownerTelNo
No
30 AN
Customer’s telephone number
ownerTown
No
40 AN
Customer’s town/city name
ownerZip
No
10 AN
Customer’s street name and number
 
Secure Inputs
Input Fields
Required
Character Limits/
Required Input
Description
cardNumber
Yes
19 chars
Secure input of the card number
cardExpiryDate
Yes
4 chars
Secure input of the card expiry - in the format MMYY
cardSecurityCode
Yes
3 or 4 chars
Secure input of the card CVV, either three or four digits long depending on the card
 
Outputs
Output Fields
Description
ncError
Error code
orderId
Your order reference
payId
Payment reference in the DirectLink system
status
The message displayed from the transaction
acceptance
Acceptance code returned by acquirer
amount
Order amount
brand
Card brand or similar information for other payment methods
currency
Order currency
eci
Electronic Commerce Indicator
ncErrorPlus
Explanation of the error code
ncStatus
First digit of NCERROR
pm
Payment method
errorMessage
PCI Pal Specific Error Message.  If anything goes wrong in the sending of a request, our internal error handling will respond with a message on the output of the flow
 
DirectLink Logic Item
The DirectLink Logic Item contains the following properties:
Barclays EPDQ (DirectLink) Payment Gateway
1

PSP ID

Your affiliation name in our system
2

User ID

API User name given to the client by the DirectLink gateway
3

Password

Password of the API user (USERID)
4

SHA Passphrase

Passphrase given to the client from DirectLink in order to create the signature
5

Success Status Code

Each gateway has its own unique selection of status codes on a request back from the gateway - for DirectLink, this is: 3,9
6

Select Endpoint

  For added security the DirectLink endpoints have been hardcoded into the integration.  EPDQ Test or Live needs to be selected from the Select Endpoint drop down list, depending on the transaction being conducted
7

Hash Algorithm

DirectLink uses SHA hashing to create a signature. The following three types are possible:
- SHA-1
- SHA-256
- SHA-512
 
For more details, please contact support@pcipal.com, and ask for a copy of the integration documentation for DirectLink.
The help manual was created with Dr.Explain