(c) PCI Pal 2020. The content on this page is subject to the Disclaimer Section (found on the Introduction page)
PayNext Payment Gateway
This page details the inputs, secure inputs and outputs available for the PayNext Payment Gateway, how to complete each field, and an external link to the PayNext 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
Username
Y
N/A
Unique API Username provided to the client by PayNext
Password
Y
N/A
Unique Terminal ID provided to the client by PayNext
UsesCount
Y
N/A
Number of times the single use PaymentToken can be used
CardHolder
Y
N/A
Card Holder Name - the name on the front of the card
CorrelationId
Y
N/A
Unique payment Correlation ID
PaymentToken
Y
N/A
Unique payment token generated by the SavePayment method, to be used in Authorisations.
CountryCode
Y
N/A
Alpha character country code e.g. US, GB, CA, FR
Currency
Y
N/A
3 Digit ISO code for the currency of the transaction. e.g. USD, CAD, GBP, EUR
Amount
Y
N/A
Amount to be authorised.
BillingAddressCity
N
N/A
Billing Address City
BillingAddressCompany
N
N/A
Billing Address Company Name
BillingAddressCountryCode
N
N/A
Alpha character Billing Address country e.g. US, GB, CA, FR
BillingAddressEmail
N
N/A
Billing Address Email Address
BillingAddressFirstName
N
N/A
Billing Addres First Name
BillingAddressLastName
N
N/A
Billing Address Last Name
BillingAddressPhone
N
N/A
Billing Address Phone Number
BillingAddressState
N
N/A
Billing Address State Code
BillingAddressStreet1
N
N/A
Billing Address Street Line 1
BillingAddressStreet2
N
N/A
Billing Address Street Line 2
BillingAddressType
N
N/A
Billing Address Type
BillingAddressZip
N
N/A
Billing Address ZIP/Postal Code
BillingAddressCounty
N
N/A
Billing Address County
BillingAddressDistrict
N
N/A
Billing Address District
BillingAddressStreetNumber
N
N/A
Billing Address Street Number
BillingAddressStreetNumberAdditional
N
N/A
Billing Address Street Number Additional Value
BillingAddressCareOf
N
N/A
Billing Address Care Of
Description
N
N/A
Payment Description
ShippingAddressCity
N
N/A
Shipping Address City
ShippingAddressCompany
N
N/A
Shipping Address Company
ShippingAddressCountryCode
N
N/A
Shipping Address Country Code
ShippingAddressEmail
N
N/A
Shipping Address Email Address
ShippingAddressFirstName
N
N/A
Shipping Address First Name
ShippingAddressLastName
N
N/A
Shipping Address Last Name
ShippingAddressPhone
N
N/A
Shipping Address Phone Number
ShippingAddressState
N
N/A
Shipping Address State
ShippingAddressStreet1
N
N/A
Shipping Address Street Line 1
ShippingAddressStreet2
N
N/A
Shipping Address Street Line 2
ShippingAddressType
N
N/A
Shipping Address Type
ShippingAddressZip
N
N/A
Shipping Address ZIP/Postal Code
ShippingAddressCounty
N
N/A
Shipping Address County
ShippingAddressDistrict
N
N/A
Shipping Address District
ShippingAddressStreetNumber
N
N/A
Shipping Address Street Number
ShippingAddressStreetNumberAdditional
N
N/A
Shipping Address Street Number Additional
ShippingAddressCareOf
N
N/A
Shipping Address Care Of
ExternalId
Y
N/A
External ID used by the customer to track individual transactions
CustomerId
N
N/A
Customer ID
Secure Inputs
Input Fields
Required
Character Limits/
Required Input
Description
CardNumber
Yes
19 num
Secure input of the card number
Expiry
Yes
2 num
Secure input of the card expiry - in the format MM
CVC
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
SecurityToken
Security Token returned from initial CreateToken request
ShopActionRequired
True or false value as to whether further action is required
Success
True or false value as to whether the transaction was successful or not
AuthorizationDone
True or false value as to whether the authorization was completed nor not
TransactionToken
Transaction token recieved from the Authorize request
PaymentToken
Payment token returned from the SavePayment request. This value is used downstream.
CreateTokenResponse
Full response for the CreateToken method
SavePaymentResponse
Full response for the SavePayment method
AuthorizeResponse
Full Response for the Authorize method
errormessage
PCI Pal error message
For more details, please contact support@pcipal.com, and ask for a copy of the integration documentation for PayNext.
