Logo | |
Info | Heartland |
Type |
Introduction
For more information about acquirers and connection, integration with Computop Paygate and Implementation of 3-D Secure (2.x), see chapter Card processing - common introduction.
Specific parameters for Heartland
Besides the general parameters described above for the credit card connection, Heartland requires the following additional parameters.
Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter.
The following table describes the additional encrypted payment request parameters described below for "interface via form" and "interface via Server-to-Server" :
Key | Format | CND | Description |
RefNr | ns..30 | M | Merchant’s unique reference number, which serves as payout reference in the acquirer EPA file. Please note, without the own shop reference delivery you cannot read out the EPA transaction and regarding the additional Computop settlement file (CTSF) we cannot add the additional payment data. Only ASCII characters allowed, special characters ("Umlaute", diacritics) are not allowed and must be replaced by their ASCII-representation (e.g. ü → ue, é → e, ...). |
Contact data/Address verification (AVS) | |||
FirstName | ans..100 | O | First name of the customer |
LastName | ans..100 | O | Last name of the customer |
AddrStreet | ans..128 | O | Street name and house number |
AddrZip | ans..20 | O | Postcode |
AddrCity | ans..50 | O | City |
AddrState | a2 | O | Code of the customer’s Federal State |
AddrCountryCode | a2/a3 | M | Country code according to ISO-3166-1, alphanumeric 2 or 3 chars |
Additional parameters for credit card payments
The following table describes the result parameters with which the Computop Paygate responds to your system.
these result parameters are additional to the standard parameters for "interface via form" and "interface via Server-to-Server" described below
pls. be prepared to receive additional parameters at any time and do not check the order of parameters
the key (e.g. MerchantId, RefNr) should not be checked case-sentive
Key | Format | CND | Description |
RefNr | ns..30 | O | Merchant’s unique reference number, which serves as payout reference in the acquirer EPA file. Please note, without the own shop reference delivery you cannot read out the EPA transaction and regarding the additional Computop settlement file (CTSF) we cannot add the additional payment data. Only ASCII characters allowed, special characters ("Umlaute", diacritics) are not allowed and must be replaced by their ASCII-representation (e.g. ü → ue, é → e, ...). |
ErrorText | ans..128 | O | Error text from the downstream system, only when its response is discussed with Computop Helpdesk. |
CodeExt | ans..10 | O | Only if configured: External error code (downstream system) |
ApprovalCode | an6 | O | External approval code (downstream system). Exists only if authorisation was successful. |
HpsTransactionID | n10 | O | TransaktionsID issued by Heartland: returned if authorisation is okay |
HpsReferenceNumber | n12 | O | ReferenceNumber issued by Heartland: returned if authorisation is okay |
Match | a1 | O | Result of address check: Parameter is returned depending on merchant configuration as simplified Match parameter or as returned by Heartland; details see: A3 AVS match parameters |
Additional response parameters for credit card payments
Card processing - Credit Card Form
For more information about credit card processing via forms, please see chapter Credit Card Form (paySSL).
Card processing - Server-2-Server integration
For more information about credit card processing via server-to-server communication, please see chapter Server-2-Server Integration.
Capture / Credit / Reversal
For more information about capture, credit, reversal and credit card payment via POS terminals, please see chapter Card processing - Capture / Credit / Reversal / PayNow / Batch.
PayNow
For more information about PayNow, please see chapter Card processing - Capture / Credit / Reversal / PayNow / Batch.
Batch processing via the interface
For more information about batch processing, please see chapter Card processing - Capture / Credit / Reversal / PayNow / Batch.