Send Travel and Entertainment data for Visa, Mastercard and American Express

You can pass industry-specific data with additional data for Visa, Mastercard and American Express:

Passing this data can function as additional fraud protection or be used for reporting purposes by (commercial) shoppers, as well as improve interchange rates by qualifying for industry-specific rates.

This functionality is available for Ecommerce (API, CSE) and Hosted-Payment Pages and Checkout. Before using this functionality, check that you can submit travel and entertainment data.

Sending additional data

Specific data can be sent with an authorise or capture request as additional data items. Sending this data is optional. You can always submit a regular capture request without any additional data.

There are two ways to provide industry-specific additional data:

  1. When you have configured your account to "auto capture", you can submit the main payment data  (amount, currency, card details)  with the /payments request and industry-specific additional data.
  2. You can also /capture  manually, in this case submit industry-specific additional data in the additionalData object. 

For car rental and lodging data, you must include the following fields with the  /authorise request:

  • travelEntertainmentAuthData.market
  • travelEntertainmentAuthData.duration 

Never submit multiple additional datasets in a single payment request.

Code examples

Lodging data

For a full list of lodging data fields, see Lodging fields.

{
   "amount":{
      "currency":"EUR",
      "value":"10"
   },
   "merchantAccount":"TestMerchant",
   "reference":"Lodging_MC_2",
   "shopperStatement":"Lodging_MC_2",
   "shopperInteraction":"Ecommerce",
   "paymentMethod":{
      "type":"scheme",
      "number":"4111 1111 1111 1111",
      "expiryMonth":"08",
      "expiryYear":"2018",
      "cvc":"737",
      "holderName":"Simon Hopper"
   },
   "additionalData":{
      "lodging.customerServiceTollFreeNumber":"1800433999",
      "lodging.checkInDate":"20180302",
      "lodging.checkOutDate":"20180304",
      "lodging.folioNumber":"13579111315",
      "lodging.propertyPhoneNumber":"1800433999",
      "lodging.room1.rate":"50",
      "lodging.room1.tax":"0",
      "lodging.room1.numberOfNights":"2",
      "lodging.fireSafetyActIndicator":"Y"
   }
}

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:com="http://common.services.adyen.com" xmlns:pay="http://payment.services.adyen.com">
   <soapenv:Header />
   <soapenv:Body>
      <pay:authorise>
         <pay:paymentRequest>
            <pay:additionalData>
                <pay:entry>
                  <pay:key>lodging.customerServiceTollFreeNumber</pay:key>
                  <pay:value>1800433999</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>lodging.checkInDate</pay:key>
                  <pay:value>20180302</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>lodging.checkOutDate</pay:key>
                  <pay:value>20180304</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>lodging.folioNumber</pay:key>
                  <pay:value>13579111315</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>lodging.propertyPhoneNumber</pay:key>
                  <pay:value>1800433999</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>lodging.room1.rate</pay:key>
                  <pay:value>50</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>lodging.room1.tax</pay:key>
                  <pay:value>0</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>lodging.room1.numberOfNights</pay:key>
                  <pay:value>2</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>lodging.fireSafetyActIndicator</pay:key>
                  <pay:value>Y</pay:value>
               </pay:entry>
            </pay:additionalData>
            <pay:amount>
               <com:currency>USD</com:currency>
               <com:value>10</com:value>
            </pay:amount>
            <pay:paymentMethod>
               <pay:type>scheme</pay:type>
               <pay:cvc>***</pay:cvc>
               <pay:expiryMonth>**</pay:expiryMonth>
               <pay:expiryYear>****</pay:expiryYear>
               <pay:holderName>Simon Hopper</pay:holderName>
               <pay:number>**********</pay:number>
            </pay:paymentMethod>
            <pay:merchantAccount>AdyenMessengerPaymentsUS</pay:merchantAccount>
            <pay:reference>Lodging_MC_2</pay:reference>
            <pay:shopperStatement>Lodging_MC_2</pay:shopperStatement>
            <pay:shopperInteraction>Ecommerce</pay:shopperInteraction>
         </pay:paymentRequest>
      </pay:authorise>
   </soapenv:Body>
</soapenv:Envelope>

Car rental data

 For a full list of car rental data fields, see Car rental fields.

{
   "amount":{
      "currency":"EUR",
      "value":"10"
   },
   "merchantAccount":"TestMerchant",
   "reference":"CarRental_MC_6",
   "shopperStatement":"CarRental_MC_6",
   "shopperInteraction":"Ecommerce",
   "paymentMethod":{
      "type":"scheme",
      "number":"4111 1111 1111 1111",
      "expiryMonth":"08",
      "expiryYear":"2018",
      "cvc":"737",
      "holderName":"Simon Hopper"
   },
   "additionalData":{
      "carRental.rentalAgreementNumber":"123456789",
      "carRental.renterName":"Simon Hopper",
      "carRental.returnCity":"San Francisco",
      "carRental.returnStateProvince":"CA",
      "carRental.returnCountry":"US",
      "carRental.returnLocationId":"1234",
      "carRental.checkOutDate":"20180101",
      "carRental.customerServiceTollFreeNumber":"5550100123",
      "carRental.rate":"10",
	  "carRental.rateIndicator":"D",
      "carRental.daysRented":"1",
      "carRental.locationCity":"San Francisco",
      "carRental.locationStateProvince":"CA",
      "carRental.locationCountry":"US",
      "carRental.rentalClassId":"0001",
      "carRental.returnDate":"20180102"
   }
}
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:com="http://common.services.adyen.com" xmlns:pay="http://payment.services.adyen.com">
   <soapenv:Header />
   <soapenv:Body>
      <pay:authorise>
         <pay:paymentRequest>
            <pay:additionalData>
               <pay:entry>
                  <pay:key>carRental.rentalAgreementNumber</pay:key>
                  <pay:value>123456789</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>carRental.renterName</pay:key>
                  <pay:value>Simon Hopper</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>carRental.returnCity</pay:key>
                  <pay:value>San Francisco</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>carRental.returnStateProvince</pay:key>
                  <pay:value>CA</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>carRental.returnCountry</pay:key>
                  <pay:value>US</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>carRental.returnLocationId</pay:key>
                  <pay:value>1234</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>carRental.checkOutDate</pay:key>
                  <pay:value>20190101</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>carRental.customerServiceTollFreeNumber</pay:key>
                  <pay:value>5550100123</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>carRental.rate</pay:key>
                  <pay:value>10</pay:value>
               </pay:entry>
				<pay:entry>
                  <pay:key>carRental.rateIndicator</pay:key>
                  <pay:value>D</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>carRental.rateIndicator</pay:key>
                  <pay:value>D</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>carRental.daysRented</pay:key>
                  <pay:value>1</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>carRental.locationCity</pay:key>
                  <pay:value>San Francisco</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>carRental.locationStateProvince</pay:key>
                  <pay:value>CA</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>carRental.locationCountry</pay:key>
                  <pay:value>US</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>carRental.rentalClassId</pay:key>
                  <pay:value>0001</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>carRental.returnDate</pay:key>
                  <pay:value>20180102</pay:value>
               </pay:entry>
            </pay:additionalData>
            <pay:amount>
               <com:currency>USD</com:currency>
               <com:value>10</com:value>
            </pay:amount>
            <pay:paymentMethod>
               <pay:type>scheme</pay:type>
               <pay:cvc>***</pay:cvc>
               <pay:expiryMonth>12</pay:expiryMonth>
               <pay:expiryYear>2020</pay:expiryYear>
               <pay:holderName>Simon Hopper</pay:holderName>
               <pay:number>6789101112131415</pay:number>
            </pay:paymentMethod>
            <pay:merchantAccount>AdyenMessengerPaymentsUS</pay:merchantAccount>
            <pay:reference>CarRental_MC_6</pay:reference>
            <pay:shopperStatement>CarRental_MC_6</pay:shopperStatement>
            <pay:shopperInteraction>Ecommerce</pay:shopperInteraction>
         </pay:paymentRequest>
      </pay:authorise>
   </soapenv:Body>
</soapenv:Envelope>

Airline data

 For a full list of airline data fields, see Airline fields.

{
   "amount":{
      "currency":"EUR",
      "value":"10"
   },
   "merchantAccount":"TestMerchant",
   "reference":"CarRental_MC_6",
   "shopperStatement":"CarRental_MC_6",
   "shopperInteraction":"Ecommerce",
   "paymentMethod":{
      "type":"scheme",
      "number":"4111 1111 1111 1111",
      "expiryMonth":"08",
      "expiryYear":"2018",
      "cvc":"737",
      "holderName":"Simon Hopper"
   },
	"additionalData":{
      "airline.passenger_name":"Simon Hopper",
      "airline.ticket_number":"1234567891011",
      "airline.airline_code":"KLM",
      "airline.flight_date":"2016-03-22 11:00",
      "airline.leg1.carrier_code":"KL",
      "airline.leg1.class_of_travel":"F",
      "airline.leg1.depart_airport":"AMS",
      "airline.leg1.destination_code":"CDG",
      "airline.leg1.stop_over_code":"X",
      "airline.leg1.fare_base_code":"F",
      "airline.leg1.flight_number":"1234",
      "airline.leg2.carrier_code":"AF",
      "airline.leg2.class_of_travel":"Y",
      "airline.leg2.depart_airport":"CDG",
      "airline.leg2.destination_code":"AMS",
      "airline.leg2.stop_over_code":"X",
      "airline.leg2.fare_base_code":"Y",
      "airline.leg2.flight_number":"4321",
      "airline.computerized_reservation_system":"SABR"
   }
}


<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:com="http://common.services.adyen.com" xmlns:pay="http://payment.services.adyen.com">
   <soapenv:Header />
   <soapenv:Body>
      <pay:authorise>
         <pay:paymentRequest>
            <pay:additionalData>
               <pay:entry>
                  <pay:key>airline.passenger_name</pay:key>
                  <pay:value>Simon Hopper</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>airline.ticket_number</pay:key>
                  <pay:value>1234567891011</pay:value>
               </pay:entry>
     		   <pay:entry>
                  <pay:key>airline.airline_code</pay:key>
                  <pay:value>KLM</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>airline.flight_date</pay:key>
                  <pay:value>2016-03-22 11:00</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>airline.leg1.carrier_code</pay:key>
                  <pay:value>KL</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>airline.leg1.class_of_travel</pay:key>
                  <pay:value>F</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>airline.leg1.depart_airport</pay:key>
                  <pay:value>AMS</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>airline.leg1.destination_code</pay:key>
                  <pay:value>CDG</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>airline.leg1.stop_over_code</pay:key>
                  <pay:value>X</pay:value>
               </pay:entry>
				<pay:entry>
                  <pay:key>airline.leg1.fare_base_code</pay:key>
                  <pay:value></pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>airline.leg1.flight_number</pay:key>
                  <pay:value>1234</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>airline.leg2.carrier_code</pay:key>
                  <pay:value>AF</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>airline.leg2.class_of_travel</pay:key>
                  <pay:value>Y</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>airline.leg2.depart_airport</pay:key>
                  <pay:value>CDG</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>airline.leg2.destination_code</pay:key>
                  <pay:value>AMS</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>airline.leg2.stop_over_code</pay:key>
                  <pay:value>X</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>airline.leg2.fare_base_code</pay:key>
                  <pay:value></pay:value>
               </pay:entry>
 			  <pay:entry>
                  <pay:key>airline.leg2.flight_number</pay:key>
                  <pay:value>4321</pay:value>
               </pay:entry>
               <pay:entry>
                  <pay:key>airline.computerized_reservation_system</pay:key>
                  <pay:value>SABR</pay:value>
               </pay:entry>
            
            </pay:additionalData>
            <pay:amount>
               <com:currency>USD</com:currency>
               <com:value>10</com:value>
            </pay:amount>
            <pay:paymentMethod>
               <pay:type>scheme</pay:type>
               <pay:cvc>***</pay:cvc>
               <pay:expiryMonth>12</pay:expiryMonth>
               <pay:expiryYear>2020</pay:expiryYear>
               <pay:holderName>Simon Hopper</pay:holderName>
               <pay:number>6789101112131415</pay:number>
            </pay:paymentMethod>
            <pay:merchantAccount>AdyenMessengerPaymentsUS</pay:merchantAccount>
            <pay:reference>CarRental_MC_6</pay:reference>
            <pay:shopperStatement>CarRental_MC_6</pay:shopperStatement>
            <pay:shopperInteraction>Ecommerce</pay:shopperInteraction>
         </pay:paymentRequest>
      </pay:authorise>
   </soapenv:Body>
</soapenv:Envelope>