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.
Sending additional data
There are two ways to provide industry-specific additional data:
- 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.
-
Make a
/capture
request where you can also pass industry-specific additional data in theadditionalData
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>