(c) PCI Pal 2020. The content on this page is subject to the Disclaimer Section (found on the Introduction page)
Paytrace Payment Gateway (Sale)
This page details the inputs, secure inputs and outputs available for the Paytrace Payment Gateway, how to complete each field, and an external link to the Paytrace 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
integratorId
Yes
50 char
A unique ID to correlate an API consumers calls to the PayTrace system.
username
Yes
50 char
PayTrace API Username
password
Yes
50 char
Password for PayTrace API
amount
Yes
Num, 2 decimal places
The dollar amount of the transaction. This must be a positive number up to two decimal places.
billingStreetAddress
No
50 char
Street of the Billing Address that is on file for the cardholder's account. This attribute is only required if the "Require Billing Address" field is enabled on the PayTrace account.
billingCity
No
50 char
City of the Billing Address that is on file for the cardholder's account.
billingState
No
50 char
State of the Billing Address that is on file for the cardholder's account.
billingZip
No
50 char
ZIP code of the Billing Address that is on file for the cardholder's account. This attribute is only required if the "Require Billing ZIP" field is enabled on the PayTrace account.
Secure Inputs
Inputs Fields
Required
Character Limits/Required Input
Description
number
Yes
19 char
Secure input of the card number
expiration
Yes
4 char
Secure input of the card expiry - in the format MMYY
csc
Yes
3 or 4 char
Secure input of the card CVV, either three or four digits long depending on the card
Outputs
Output Fields
Description
error
A description of any error that occurred during the request. Blank for a successful transaction.
success
This flag will indicate if the request is successful.
Possible values: true/false.
True indicates that the request was successful and had no errors.
False indicates that the request was not successful and some kind of error has occurred.
responseCode
This code will show you the response code based on the request execution status.
statusMessage
The status message about the request that provides additional information about the request execution end result.
maskedCardNumber
The credit card number with all digits masked and replaced with 'x' except the last 4 digits.
avsResponse
A unique string identifier returned by the AVS.
cscResponse
A unique string identifier returned by the card issuer on CSC verification.
approvalCode
This code is generated by the credit card issuer and returned with a successful transaction.
transactionId
A unique identifier for each transaction in the PayTrace system.
approvalMessage
The transaction approval message from the processing networks.
externalTransactionId
A unique identifier of the request from your system which will be returned in the response.
Further information can be found by viewing the integration documentation:
