Elavon Only: Digital Wallet Authorizations

Elavon supports Samsung Pay digital wallet transactions. A Samsung Pay digital wallet uses tokenization to prevent sensitive card data from being exposed or intercepted during transactions. A token is generated when a user adds a supported card to their Samsung Pay digital wallet.

Elavon supports 3-D Secure 2.2 with Diners Club, Mastercard, and Visa card transactions.

Supported processors: Elavon

Endpoints

Without 3-D Secure

When 3-D Secure is not used, the transaction ID is automatically populated with the cryptogram value.

Follow these steps to request a Samsung Pay payment on a supported card without 3-D Secure authentication:

1. Create the request message with the required REST API fields. These REST API fields are specific to this request payload:

   • merchantInformation.merchantDomain
   • paymentInformation.tokenizedCard.cryptogram
   • paymentInformation.tokenizedCard.transactionType
   • processingInformation.commerceIndicator
   • processingInformation.paymentSolution

2. Send the message to the endpoint listed in the Endpoints section.

3. Verify the response messages to make sure that the request was successful. A 200-level HTTP response code indicates success.

4. If the response message contains errors, see Common Error Responses.

Example

{  "clientReferenceInformation": {    "code": "MC-NO3DS-SAMSUNGPAY-004"  },  "orderInformation": {    "amountDetails": {      "totalAmount": "67.50",      "currency": "EUR"    },    "billTo": {      "firstName": "Hans",      "lastName": "Mueller",      "address1": "Alexanderplatz 1",      "locality": "Berlin",      "postalCode": "10178",      "country": "DE",      "email": "[email protected]",      "phoneNumber": "+49-30-12345678"    }  },  "paymentInformation": {    "tokenizedCard": {      "cryptogram": "CwABBJQ0AgAAAAAgJDUCAAAAAAA=",      "transactionType": "1",      "expirationMonth": "04",      "expirationYear": "2028",      "type": "002"    }  },  "processingInformation": {    "paymentSolution": "008",    "commerceIndicator": "internet"  },  "merchantInformation": {    "merchantId": "demo_merchant_12345"  }}

These REST API fields are required to request authorization of a Samsung Pay digital wallet payment without 3-D Secure authentication.

With 3-D Secure 2.2

Follow these steps to authorize a Samsung Pay payment on a supported card with 3-D Secure authentication:

1. Create the request message with the required REST API fields. These REST API fields are specific to this payload:

   • merchantInformation.merchantDomain
   • consumerAuthenticationInformation.cavv — Diners Club and Visa only
   • consumerAuthenticationInformation.ucafAuthenticationData — Mastercard only
   • consumerAuthenticationInformation.ucafCollectionIndicator — Mastercard only
   • paymentInformation.tokenizedCard.cryptogram
   • paymentInformation.tokenizedCard.transactionType
   • paymentInformation.tokenizedCard.type
   • processingInformation.commerceIndicator
   • processingInformation.paymentSolution
   • processingInformation.paymentNetworkTokenTransactionType

2. Send the message to the endpoint listed in the Endpoints section.

3. Verify the response messages to make sure that the request was successful. A 200-level HTTP response code indicates success.

Example

{  "clientReferenceInformation": {    "code": "DINERS-3DS-SAMSUNGPAY-006"  },  "orderInformation": {    "amountDetails": {      "totalAmount": "199.00",      "currency": "EUR"    },    "billTo": {      "firstName": "Pierre",      "lastName": "Dubois",      "address1": "15 Rue de la Paix",      "locality": "Paris",      "postalCode": "75001",      "country": "FR",      "email": "[email protected]",      "phoneNumber": "+33-1-42-96-12-34"    }  },  "paymentInformation": {    "tokenizedCard": {      "cryptogram": "BwABBJQ0AgAAAAAgJDUCAAAAAAA=",      "transactionType": "1",      "expirationMonth": "08",      "expirationYear": "2027",      "type": "005"    }  },  "consumerAuthenticationInformation": {    "cavv": "BgABBJQ0AgAAAAAgJDUCAAAAAA=",    "directoryServerTransactionId": "8a2+89r+vs8fsc8w+v+79y==",    "paSpecificationVersion": "2.2.0"  },  "processingInformation": {    "paymentSolution": "008",    "commerceIndicator": "pb"  },  "merchantInformation": {    "merchantId": "demo_merchant_12345"  }}

These REST API fields are required to request authorization of a Samsung Pay digital wallet payment with 3-D Secure authentication.

Common Error Responses

This section lists common error responses to transaction requests without 3-D Secure authentication.