(c) PCI Pal 2020. The content on this page is subject to the Disclaimer Section (found on the Introduction page)
DataCash Payment Gateway
This page details the inputs, secure inputs and outputs available for the DataCash Payment Gateway, how to complete each field, and an external link to the DataCash integration documentation.
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
client
Yes
n/a
Unique API Client Username provided by DataCash
password
Yes
n/a
Unqiue API User Password provided by DataCash
card_account_type
Yes
6 chars
The type of card used: credit or debit
street_address1
No
50 alphanumeric
Address Line 1 (Street)
street_address2
No
30 chars
Address Line 2 (Town/City)
street_address3
No
30 chars
Address Line 3 (State/County)
street_address4
No
50 chars
Address Line 4 (Country Name e.g. United Kingdom)
postcode
No
9 numeric
Postal Code
authcode
No
n/a
Unique Auth Code. If presented, this must be the value received from the bank authorisation centre. If any other values are sent in this field, the transaction will not be sent for authorisation.
method
Yes
6 chars
Type of payment being sent, values can be:
- auth
- pre
- refund
currency
Yes
3 chars
Alpha-3 ISO Code for the currency, e.g. GBP, USD, EUR
amount
Yes
n/a
Amount to be sent in, in pounds and pence (dollars and cents). e.g. 1.23 for £1.23 ($1.23)
cm_billing_postal_code
No
9 numeric
Billing address postal code
cm_billing_street_address
No
20 alphanumeric
Billing address
cm_first_name
No
15 alphanumeric
Customer first name
cm_last_name
No
30 alphanumeric
Customer last name
ship_to_postal_code
No
9 numeric
Shipping postal code
ship_to_address
No
50 alphanumeric
Shipping address line 1
ship_to_first_name
No
15 chars
Shipping address first name
ship_to_last_name
No
30 chars
Shipping address last name
ship_to_country_code
No
3 numeric
Shipping country code in ISO Numeric 3 format. For example, 826 == GBR
merchantreference
Yes
30 alphanumeric
Unique transaction reference sent by the merchant for each transaction.
policy
No
1 numeric
The standard policy required for the transaction: 1,2,3,5,6,7.
Secure Inputs
Input Fields
Required
Character Limits/
Required Input
Description
pan
Yes
19 num
Secure input of the card number
expirydate
Yes
2 num
Secure input of the card expiry - in the format MM
cv2
Yes
3 or 4 num
Secure input of the card CVV, either three or four digits long depending on the card
Outputs
Output Fields
Description
card_account_type_out
The type of card used. Will be either:
- credit
- debit
cv2avs_status
CV2 AVS result for the transaction. The following values could be:
- NO DATA MATCHES
- ADDRESS MATCH ONLY
- SECURITY CODE MATCH ONLY
- ALL MATCH
- DATA NOT CHECKED
address_result
The following values for the following extended check:
- notprovided
- notchecked
- matched
- notmatched
- partialmatch
cv2_result
The following values for the following extended check:
- notprovided
- notchecked
- matched
- notmatched
- partialmatch
postcode_result
The following values for the following extended check:
- notprovided
- notchecked
- matched
- notmatched
- partialmatch
address_policy
The policy the transaction was checked against
cv2_policy
The policy the transaction was checked against
postcode_policy
The policy the transaction was checked against
policyout
The policy the transaction was checked against
authcodeout
Auth code provided by DataCash for the transaction.
card_scheme
Card type that the transaction was processed with. e.g. VISA
datacash_reference
Unique DataCash reference for the transaction
merchantreferenceout
Merchant reference that the transaction was processed with.
mode
The environment which was used to send the transaction, should be TEST or LIVE
reason
A description on the transaction result, whether it was Authorised or had been Declined/Refused or had failed.
status
Status code on the transaction relating to the reason message.
time
Timestamp of the transaction
country
Country of the issuing card used in the transaction
issuer
Issuer of the card used in the transaction
errormessage
PCI Pal error message
For more details, please contact support@pcipal.com, and ask for a copy of the integration documentation for DataCash.
