Send Level 2 data for American Express

You can pass Level 2 data with additional data for American express:

Passing this data can function as additional fraud protection or be used for reporting purposes.

This functionality is available for both Checkout and Classic integrations.

Sending additional data

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

  1. When you have configured your account to "auto capture", you can make an /payments request to submit main payment data (amount, currency, card details) and industry-specific additional data, including L2 data. 
  2. Make a /capture request where you can also pass industry-specific additional data in the additionalData object. 

    Sending this data is optional. You can always submit a regular capture request without any additional data..

Code examples

Level 2 data

"additionalData":{  
   "enhancedSchemeData.customerReference":"123456789",
   "enhancedSchemeData.destinationPostalCode";"0123456789",
   "enhancedSchemeData.totalTaxAmount":"2",
   "enhancedSchemeData.itemDetailLine1.productCode":"1",
   "enhancedSchemeData.itemDetailLine1.commodityCode":"1234",
   "enhancedSchemeData.itemDetailLine1.description":"product 1",
   "enhancedSchemeData.itemDetailLine1.quantity":"12",
   "enhancedSchemeData.itemDetailLine1.unitOfMeasure":"m",
   "enhancedSchemeData.itemDetailLine1.unitPrice":"20",
   "enhancedSchemeData.itemDetailLine1.totalAmount":"240",
   "enhancedSchemeData.itemDetailLine2.productCode":"2",
   "enhancedSchemeData.itemDetailLine2.commodityCode":"4567",
   "enhancedSchemeData.itemDetailLine2.description":"product 2",
   "enhancedSchemeData.itemDetailLine2.quantity":"20",
   "enhancedSchemeData.itemDetailLine2.unitOfMeasure":"m",
   "enhancedSchemeData.itemDetailLine2.unitPrice":"3000",
   "enhancedSchemeData.itemDetailLine2.totalAmount":"60000"
}
 <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soap:Body>
    <calculateRisk xmlns="http://risk.services.adyen.com">
      <riskRequest>
        <additionalData>
         
          <entry>
            <key xsi:type="xsd:string">enhancedSchemeData.itemDetailLine1.description</key>
            <value xsi:type="xsd:string">product 1</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">enhancedSchemeData.customerReference</key>
            <value xsi:type="xsd:string">123456789</value>
          </entry>
  		 <entry>            
            <key xsi:type="xsd:string">"enhancedSchemeData.destinationPostalCode</key>
            <value xsi:type="xsd:string">0123456789</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">enhancedSchemeData.totalTaxAmount</key>
            <value xsi:type="xsd:string">2</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">enhancedSchemeData.itemDetailLine1.productCode</key>
            <value xsi:type="xsd:string">1</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">enhancedSchemeData.itemDetailLine1.quantity</key>
            <value xsi:type="xsd:string">12</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">enhancedSchemeData.itemDetailLine1.totalAmount</key>
            <value xsi:type="xsd:string">240</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">enhancedSchemeData.itemDetailLine1.commodityCode</key>
            <value xsi:type="xsd:string">1234</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">enhancedSchemeData.itemDetailLine1.unitOfMeasure</key>
            <value xsi:type="xsd:string">m</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">enhancedSchemeData.itemDetailLine1.unitPrice</key>
            <value xsi:type="xsd:string">20</value>
          </entry>
        </additionalData>
        <amount>
          <currency xmlns="http://common.services.adyen.com">USD</currency>
          <value xmlns="http://common.services.adyen.com">1000</value>
        </amount>
        <card>
          <cvc xmlns="http://payment.services.adyen.com">****</cvc>
          <expiryMonth xmlns="http://payment.services.adyen.com">12</expiryMonth>
          <expiryYear xmlns="http://payment.services.adyen.com">2022</expiryYear>
          <holderName xmlns="http://payment.services.adyen.com">TestCard Holder</holderName>
          <number xmlns="http://payment.services.adyen.com">***********1004</number>
        </card>
        <hashedCardChunk>b0DvyhQ1bdzGXV+X4Yvzki1Exhk=</hashedCardChunk>
        <hashedCardNumber>AwVD03gSRiVTuFy7n4pL8C+gQ08=</hashedCardNumber>
        <holderName>TestCard Holder</holderName>
        <merchantAccount>TestMerchant</merchantAccount>
        <merchantReference>201803121057-1000</merchantReference>
        <pspReference>99X********5070X</pspReference>
        <readOnly>false</readOnly>
        <shopperInteraction>Ecommerce</shopperInteraction>
        <skipRisk>false</skipRisk>
        <variant>amex</variant>
      </riskRequest>
    </calculateRisk>
  </soap:Body>
</soap:Envelope>