Payment

PAY

As part of the flow for Server-to-Server payments, this is the servlet exposed for authorisation request in case of 3D Secure not participating schemes (verifyenrollment with result = [NOT SUPPORTED]); it receives in input all payment details: order details, card details (eci, if present, must me equal to '07'); it returns in output the payment outcome.

This authentication mode is also used for MIT transactions as they do not require authentication by the customer.

PAYTHREESTEP

As part of the flow for Server-to-Server payments, this is the servlet exposed for authorisation request in case of [ENROLLED, NOT ENROLLED] cards; it receives in input all payment details: order details, card details, 3D Secure details, if any; it returns in output the payment outcome.

Request parameters

		NAME	DESCRIPTION	FORMAT
id Id associated with terminal N Max. length: 8 password Terminal id password AN Max. length: 50 tenantId Identification code of the acquiring service to which the merchant belongs. In the case of a merchant having an agreement with Intesa enter "10", otherwise enter "20". N operationType "pay" for the following cases: Verify enrollment with result NOT SUPPORTED For MIT payments "paythreestep" for the following cases: Verify enrollment with result ENROLLED Verify enrollment with result NOT ENROLLED "cardverification": to perform a card verification (ASI) without charge, in order to verify the validity of a card. In this mode it will be necessary to value the "amount" field to 0. "preauthorization": to perform a preauthorization, ie a temporary block of a specific amount on a payment card. It will then be necessary to perform a total or partial accounting operation, if this operation is not performed within the time limit set in the back office, the Gateway will unlock the pre-authorized amount. AN paymentid Id associated with the payment session (returned by Verify Enrollment), to use for PAYTHREESTEP cases only Object amount Transaction amount using the point as decimal separator (e.g. 1428,76€ = "1428.76"). The decimal portion may vary depending on the currency N Int. 18 - Dec. 4 currencyCode Currency numeric code (optional – default '978' [euro]) N Max. length: 3 merchantOrderId Transaction reference sent by the merchant during Initialization (can contain only letters and numbers and must be absolutely unique) AN Max. length: 18 card Credit card number N Max. length: 19 cvv2 Credit card security code N Max. length: 4 expiryMonth Credit card expiry month (mm) N Max. length: 2 expiryYear Credit card expiry year (yyyy) N Max. length: 4 eci Electronic Commerce Indicator: security level indicator of the transaction AN Max. length: 2 xid Unique Id associated with the 3D Secure process, to use for PAYTHREESTEP cases only (if returned in PaRes) AN Max. length: 255 cavv Payment signature, to use for PAYTHREESTEP cases only if returned in PaRes) AN Max. length: 255 description Payment description AN Max. length: 255 cardHolderName Cardholder name Object Max. length: 125 customField Custom field AN Max. length: 255

The ECI must be filled in with the value received in the verifyenrollment in the event of NO 3D and with the value received in the verifypares in the event of secure transaction (FULL or HALF).

Response parameters

		NAME	DESCRIPTION	FORMAT
result Transaction outcome: APPROVED = transaction authorised NOT APPROVED = transaction rejected CAPTURED = transaction confirmed AN Max. length: 20 authorizationcode Authorisation code, which is entered only if the transaction has been authorised AN Max. length: 6 paymentid Id associated with the payment session (returned by Verify Enrollment), to use for PAYTHREESTEP cases only Object merchantorderid Transaction Reference chosen by the Merchant (can contain only letters and numbers and must be absolutely unique) AN Max. length: 18 rrn Unique transaction reference generated by the Authorisation System (to be used in case of explicit posting via file) AN Max. length: 12 responsecode Response code (e.g. '000' if the transaction is authorised, in all other cases the transaction is rejected) N Max. length: 3 cardtype Circuit and type of credit card used (upon request) Amex Diners Maestro Mastercard Moneta Visa BAPAYPAL PAYPAL AN Max. length: 10 cardcountry Nationality of the used credit card AN Max. length: 255 description Payment description AN Max. length: 255 customfield Custom field sent to the merchant in Initialisation phase AN Max. length: 255 schematid Alphanumeric circuit Tid (sent only for MIT recurring payments). AN Max. length: 15 walletid Card token (sent only for MIT recurring payments). N Max. length: 18