--- title: "Required risk field reference" description: "Learn which fields to include in your payments request to trigger risk checks" url: "https://docs.adyen.com/risk-management/configure-manual-risk/required-risk-field-reference" source_url: "https://docs.adyen.com/risk-management/configure-manual-risk/required-risk-field-reference.md" canonical: "https://docs.adyen.com/risk-management/configure-manual-risk/required-risk-field-reference" last_modified: "2019-09-06T14:25:00+02:00" language: "en" --- # Required risk field reference Learn which fields to include in your payments request to trigger risk checks [View source](/risk-management/configure-manual-risk/required-risk-field-reference.md) You include a variety of fields when you send in a payment request. Some of these fields are mandatory to make a payment, for example `amount` and `reference`. Other fields such as `shopperIP`, `shopperReference` and `shopperEmail` are not always required, but strongly recommended to include. To get the most benefit out of your risk configuration, we recommend that you collect and then send in as many fields as possible in your payment request. Doing this ensures that you trigger the risk checks, as these checks depend on specific fields being present in the request. Sending in more fields will also help our risk engine to make intelligent decisions based on properties connected to a payment. For Web Drop-in/Components integrations, we [collect additional shopper data](#collect-additional-risk-data) that you send when the shopper pays, with the option for more data collection outside of the checkout page. ## Fields required for risk checks The following is a list of API fields that are required for some of our risk checks: | Field | Required for | API reference | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `billingAddress` | [Block and trust lists](/risk-management/configure-standard-risk-rules/referral-rules)- Shopper address referral list[Consistency rules](/risk-management/configure-standard-risk-rules/consistency-rules)- Billing address differs from delivery address - Billing address does not match cardholder address ([AVS](/risk-management/avs-checks)) | [/sessions](https://docs.adyen.com/api-explorer/Checkout/latest/post/sessions#request-billingAddress) [/payments](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__reqParam_billingAddress) [/authorise](https://docs.adyen.com/api-explorer/#/Payment/latest/post/authorise__reqParam_billingAddress) | | `deliveryAddress` | [Block and trust lists](/risk-management/configure-standard-risk-rules/referral-rules)- Shopper address referral list[Consistency rules](/risk-management/configure-standard-risk-rules/consistency-rules)- Billing address differs from delivery address[ShopperDNA rules](/risk-management/configure-standard-risk-rules/shopperdna-rules)- Multiple distinct delivery addresses used by shopper[Custom](/risk-management/configure-custom-risk-rules)- Custom rules - Custom lists | [/sessions](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/sessions__reqParam_deliveryAddress) [/payments](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__reqParam_deliveryAddress) [/authorise](https://docs.adyen.com/api-explorer/#/Payment/latest/post/authorise__reqParam_deliveryAddress) | | `shopperEmail` | [Block and trust lists](/risk-management/configure-standard-risk-rules/referral-rules)- Email domain referral check - Shopper email referral check[Consistency rules](/risk-management/configure-standard-risk-rules/consistency-rules)- PayPal auth-result email - Email address and shopper name comparison - Email is likely to be fake or automatically generated[ShopperDNA rules](/risk-management/configure-standard-risk-rules/shopperdna-rules)- Multiple distinct email addresses used by shopper[Velocity rules](/risk-management/configure-standard-risk-rules/velocity-rules)- Shopper initiated a transaction more than X times within a time period - Shopper email used more than X times within a time period[Custom](/risk-management/configure-custom-risk-rules)- Custom rules - Custom lists | [/sessions](https://docs.adyen.com/api-explorer/Checkout/latest/post/sessions#responses-201-shopperEmail) [/payments](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__reqParam_shopperEmail) [/authorise](https://docs.adyen.com/api-explorer/Payment/latest/post/authorise#request-shopperEmail) | | `shopperIP` | [Block and trust lists](/risk-management/configure-standard-risk-rules/referral-rules)- Shopper IP referral check[Consistency rules](/risk-management/configure-standard-risk-rules/consistency-rules)- Shopper IP originates from high-risk country - Shopper country differs from issuing country[ShopperDNA rules](/risk-management/configure-standard-risk-rules/shopperdna-rules)- Multiple distinct IP addresses used by shopper - Shopper used shared IP address[Velocity rules](/risk-management/configure-standard-risk-rules/velocity-rules)- Shopper initiated a transaction more than X times within a time period - Shopper IP used more than X times within a time period[Custom](/risk-management/configure-custom-risk-rules)- Custom rules - Custom listsThe `shopperIP` is retrieved automatically if you are using our simplified [Web Drop-in](/online-payments/build-your-integration/sessions-flow/?platform=Web\&integration=Drop-in) or [Web Components](/online-payments/build-your-integration/sessions-flow?platform=Web\&integration=Components) integration. | [/sessions](https://docs.adyen.com/api-explorer/Checkout/latest/post/sessions#responses-201-shopperIP) [/payments](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__reqParam_shopperIP) [/authorise](https://docs.adyen.com/api-explorer/#/Payment/latest/post/authorise__reqParam_shopperIP) | | `shopperName` | [Block and trust lists](/risk-management/configure-standard-risk-rules/referral-rules)- Shopper name referral check[Consistency rules](/risk-management/configure-standard-risk-rules/consistency-rules)- Email address and shopper name comparison[Custom](/risk-management/configure-custom-risk-rules)- Custom rules - Custom lists | [/sessions](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/sessions__reqParam_shopperName) [/payments](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-shopperName) [/authorise](https://docs.adyen.com/api-explorer/#/Payment/latest/post/authorise__reqParam_shopperName) | | `shopperReference` | [Block and trust lists](/risk-management/configure-standard-risk-rules/referral-rules)- Shopper reference referral check[ShopperDNA rules](/risk-management/configure-standard-risk-rules/shopperdna-rules)- Multiple distinct shopper references used by shopper[Velocity rules](/risk-management/configure-standard-risk-rules/velocity-rules)- Card/Bank account number already used by another shopper - Different cards/bank accounts used by the same shopper[Custom](/risk-management/configure-custom-risk-rules)- Custom lists | [/sessions](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/sessions__reqParam_shopperReference) [/payments](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__reqParam_shopperReference) [/authorise](https://docs.adyen.com/api-explorer/#/Payment/latest/post/authorise__reqParam_shopperReference) | | `telephoneNumber` | [Block and trust lists](/risk-management/configure-standard-risk-rules/referral-rules)- Telephone number referral check[Consistency rules](/risk-management/configure-standard-risk-rules/consistency-rules)- Email address and shopper name comparison[Custom](/risk-management/configure-custom-risk-rules)- Custom rules - Custom lists | [/sessions](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/sessions__reqParam_telephoneNumber) [/payments](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__reqParam_telephoneNumber) [/authorise](https://docs.adyen.com/api-explorer/Payment/latest/post/authorise#request-telephoneNumber) | ## Extra fields for specific cases The following table shows a number of API fields that you can use for specific risk checks or your own, custom risk setup. | Field | Required for | API reference | | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `accountInfo.accountCreationDate` | Required if you want to use the creation date option as the source for the shopper account age [consistency check](/risk-management/configure-standard-risk-rules/consistency-rules), or in [custom rules](/risk-management/configure-custom-risk-rules). To use this field, you must provide the account creation date as part of the payment request. Although the `accountInfo` object is used for 3D Secure transactions, you can also use this object to include the `accountCreationDate` in your payment request. | [/sessions](https://docs.adyen.com/api-explorer/Checkout/latest/post/sessions#request-accountInfo-accountCreationDate) [/payments](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__reqParam_accountInfo-accountCreationDate) [/authorise](https://docs.adyen.com/api-explorer/Payment/latest/post/authorise#request-accountInfo-accountCreationDate) | | `additionalData.riskdata.deliveryMethod` | Required if you want to use the delivery method [consistency check](/risk-management/configure-standard-risk-rules/consistency-rules). You can configure the values for the `deliveryMethod` field in the risk rule configuration for the delivery method check. | [/payments](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataRisk-riskdata-_customFieldName_) [/authorise](https://docs.adyen.com/api-explorer/Payment/latest/post/authorise#request-additionalData-AdditionalDataRisk-riskdata-_customFieldName_) | | `browserInfo` | Required for 3D Secure transactions, but you can also use this field in your [custom rules or lists](/risk-management/configure-custom-risk-rules). | [/payments](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-browserInfo) [/authorise](https://docs.adyen.com/api-explorer/Payment/latest/post/authorise#request-browserInfo) | | `deliveryDate` (Checkout API v69 or earlier) `deliverAt` (Checkout API v70 or later) | Required if you want to use the time to delivery [consistency check](/risk-management/configure-standard-risk-rules/consistency-rules), or if you want to use the field `hoursToDelivery` in a [custom risk rule](/risk-management/configure-custom-risk-rules). | [deliveryDate](https://docs.adyen.com/api-explorer/Checkout/69/post/payments#request-deliveryDate) [deliverAt](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-deliverAt) [/authorise](https://docs.adyen.com/api-explorer/#/Payment/latest/post/authorise__reqParam_deliveryDate) | ## Collect additional risk data For [Web Drop-in/Components](https://github.com/Adyen/adyen-web) integrations, we [collect additional data to detect fraud](/risk-management/fraud-data-collection). In addition to the data that you send when the shopper checks out, you can also optionally collect data to detect fraud outside of the checkout page. We recommend that you collect data about the shopper's activity on every page of your site. To do this, add the following script to any of your web pages. **Data collection script** ```javascript ``` When the shopper checks out, Drop-in or the Component sends all of the data collected by the script to Adyen. This includes the data from the checkout page as well as any data collected from other web pages that contain the script. If your integration uses the Advanced flow, you must include the following in the [/payments](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments) request. | Field | Required for | API reference | | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | `riskData` | Required to send [device characteristics and other data](/risk-management/fraud-data-collection) that we use to detect fraudulent payment activity, and mitigate fraud. If you collect additional data from other pages on your website, that data is also included in this object. | [/payments](https://docs.adyen.com/api-explorer/Checkout/71/post/payments#request-riskData) |