Logo |
|
Info | CAPN: American Express |
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 CAPN: American Express
Besides the general parameters described below for the credit card connection, CAPN requires the following additional parameters. An authorisation with 3-D Secure is possible.
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 | ans..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. Notice: RefNr has different format restrictions depending on the AMEX EPA/settlement file: CAPN --> AMEX GRRCN EPA = 30-characters alphanumeric Notice: Please note that AMEX reference numbers can only be reported in GRRCN format accounting files. With CAPN, EPA files do not receive any references for assignment. Details on the EPA-format are provided to you by your acquirer. Only ASCII characters allowed, special characters ("Umlaute", diacritics) are not allowed and must be replaced by their ASCII-representation (e.g. ü → ue, é → e, ...). |
OrderDesc | ans..768 | M | Description of purchased goods, unit prices etc. |
AmountAuth | n..10 | O | Prepaid card: Actually authorised amount in the smallest currency unit. Please contact Computop Helpdesk as this function must also be activated at the Paygate. |
ContractID | n..8 | O | Further reference which can be used to retrieve the combination TerminalID/Contract partner number |
Key | Format | CND | Contact data/Address verification (AVS) |
FirstName | ans..15 | O | First name of the customer (for AVS) |
LastName | ans..30 | O | Last name of the customer (for AVS) |
AddrStreet | ans..20 | O | Street name and street number, e.g. 18850~N~56~ST~#301 (for AVS) |
AddrZip | n..9 | O | Postcode (for AVS) |
ans..60 | O | Email address of the customer (for AVS) | |
Phone | n..10 | O | Phone number of the customer: for countries which do not use this system, please send the last 10 digits (for AVS) |
sdFirstName | ans..15 | O | First name in the delivery address (for AVS) |
sdLastName | ans..30 | O | Last name in the delivery address (for AVS) |
sdStreet | ans..50 | O | Street name and street number in th delivery address, e.g. 4102~N~289~ST~#301 (for AVS) |
sdZip | n..9 | O | Postcode in the delivery address |
sdCountryCode | n3 | O | Country code of the delivery address according to ISO-3166-1 numeric (3-digits) (for AVS) |
sdPhone | ans..10 | O | Phone number in the delivery address: for countries which do not use this system, please send the last 10 digits (for AVS) |
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 | ans..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, ...). |
CodeExt | n..10 | O | Error code from CAPN, if agreed with Computop Helpdesk |
ApprovalCode | n..6 | O | Approval code of the transaction |
TransactionID | ans..48 | O | Transaction ID from CAPN |
AmountAuth | n..10 | M | Authorised amount in the smallest currency unit.For prepaid cards this can be less than the initially requested amount. |
Match | a1 | O | Total result of address check (American Express via CAPN): For possible values see A3 AVS match parameters |
cvcmatch | a1 | C | Result of CVC check. Possible values: M = Match, N = No match, U = Issuer unable to process request |
PAR | ans..999 | O | Payment Account Reference data provided mainly by VISA/MC or AMEX, which is a non-financial reference number assigned to each unique Primary Account Number (PAN) and mapped to all its affiliated payment tokens. |
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.