Versions Compared

Old Version 1

changes.mady.by.user writer

Saved on

compared with

New Version 2

changes.mady.by.user writer

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


...

Specific parameters for

...

CAPN

...

: American Express

Besides the general parameters described above below for the credit card connection, AMEX CAPN requires the following additional parameters:. An authorisation with 3-D Secure is possible.


Notice: For security reasons, Axepta Platform rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter.

(info) The following table describes the additional encrypted payment request parameters described below for "interface via form" and "interface via Server-to-Server" :



RefNr

ns..12

Parameter

Format

CND

Description

AmountAuth

n..10

M

Prepaid card: Actually authorised amount in the smallest currency unit

ContractIDn..8OFurther reference which can be used to retrieve the combination TerminalID/Contract partner number

RefNr

an12

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

additional BNP settlement file (CTSF) we cannot add the additional payment data.

Notes

  • Fixed length of 12 characters (only characters (A..Z, a..z) and digits (0..9) are allowed, no special characters like whitespace, underscore...)
    • If the number of characters entered is lower than 12, BNP will complete, starting from the left side, with "0" (Example : 000018279568)

    Note: RefNr has different format restrictions depending on the AMEX EPA/settlement file:

    CAPN --> AMEX GRRCN EPA = 30-characters alphanumeric

    CAPN --> standard AMEX EPA-DE (EPAGR) = 9-digits numeric

    (info) Note: the EPA format has changed and the RefNr is now shown at a different position.

    CAPN + DE-EPA Format: starting on position 24 = ReferenceNumber

    Details on the EPA-format are provided to you by your acquirer.

    OrderDesc

    ans..768

    M

    Description of purchased goods, unit prices etc.

    AmountAuth

    n..10

    M

    Prepaid card: Actually authorised amount in the smallest currency unit.

    ContractIDn..8OFurther reference which can be used to retrieve the combination TerminalID/Contract partner number
    KeyFormatCNDContact 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)

    eMail

    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 gives describes the result parameters with which Payment platform responds:the Axepta Platform responds to your system.

    (info) these result parameters are additional to the standard parameters for "interface via form" and "interface via Server-to-Server" described below

    (info) pls. be prepared to receive additional parameters at any time and do not check the order of parameters

    (info) the key (e.g. MerchantId, RefNr) should not be checked case-sentive



    RefNr

    ns..12

    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 BNP settlement file (CTSF) we cannot add the additional payment data.

    It is returned only for EVO partners.

    CodeExt

    n..10

    O

    Error code from CAPN

    . 

    , if agreed with Axepta 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 manual Match A3 AVS match parameters.

    cvcmatcha1C

    Result of CVC check.

    Possible values: M = Match, N = No match, U = Issuer unable to process request

    PARans..999O

    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