Google's AI surfaces provide contextual data to merchants to help them assess
transaction risk and make decisions on whether or not they want to proceed with
the transactions. This allows merchants to be in full control of the purchases
that happen on their platforms.

This data is primarily shared during the **Complete Checkout** API call.

In the **2026-04-08** specification, these signals are found within the
`signals` object and use `com.google.` and `dev.ucp.` prefixes for signal names.

> [!IMPORTANT]
> **Important:** The `signals` object is an open-ended map. Google might add new risk signals to this object without prior notice. To prevent request failures, your API implementation must gracefully ignore any unknown or undocumented keys.

Google shares the following data types with merchants:

## Session Data

| Signal Name | Description | API Path |
|---|---|---|
| IP Address | IP address of the user in the session. | `com.google.ip_address` `dev.ucp.buyer_ip` |
| Session Start Time | Time when the purchase was initiated (Unix epoch timestamp). | `com.google.session_start_time` |

> [!NOTE]
> **Note:** These session data signals are included in all requests.

## Device Data

| Signal Name | Description | API Path |
|---|---|---|
| Device Type | Type of device being used (e.g., `MOBILE`, `DESKTOP`, `TABLET`, or `UNKNOWN`). Derived from User Agent. | `com.google.device_type` |
| Device Timezone | Current timezone of the device being used in the session. | `com.google.device_timezone` |

> [!NOTE]
> **Note:** These device data signals are included in all requests.

## Location Data

The following coarse geographic location signals are derived to assist with
fraud prevention and account takeover detection.

| Signal Name | Description | API Path |
|---|---|---|
| User Country | The coarse country location of the buyer (e.g., `United States`). | `com.google.user_country` |
| User State | The coarse state or province location of the buyer (e.g., `California`). | `com.google.user_state` |

## Browser Data

| Signal Name | Description | API Path |
|---|---|---|
| User Agent | Browser client information string. | `dev.ucp.user_agent` |
| Browser Language | Language being used in the browser on the device (e.g., "en"). | `com.google.locale` |
| Viewport Height | Height of the browser viewport in pixels. | `com.google.viewport_height_px` |
| Viewport Width | Width of the browser viewport in pixels. | `com.google.viewport_width_px` |

## Order Data

The following data points are available within the `Create/Update Checkout` API
calls and provide context for the order:

| Signal Name | Description | API Path (`Create/Update Checkout`) |
|---|---|---|
| Product ID | Helps the merchant identify the item. | `line_items[x].item.id` |
| Fulfillment ID | Helps determine delivery type and method. | *Varies based on fulfillment setup* |

## Shipping \& Billing Data

Address and buyer information is primarily provided during the `Create/Update
Checkout` API calls.

- **Buyer Information:**

| Signal Name | Description | API Path (`Create/Update Checkout`) |
|---|---|---|
| User's Email ID | Signed-in user's Google Email ID. | `buyer.email` |

- **Shipping Address:** Available in `Create/Update Checkout` under `fulfillment.methods.destinations[x]` (where `type` is "shipping" and `x` is the `selected_destination_id`).

| Signal Name | Description | API Path | Optional |
|---|---|---|---|
| First Name | Recipient's first name | `first_name` | No |
| Last Name | Recipient's last name | `last_name` | No |
| Full Name | Recipient's full name | `full_name` | Yes |
| Phone Number | Recipient's phone number | `phone_number` | Yes |
| Street Address | Main street address line | `street_address` | No |
| Extended Address | Apartment, suite, etc. | `extended_address` | Yes |
| City | City or locality | `address_locality` | No |
| Region | State or region | `address_region` | No |
| Postal Code | ZIP or postal code | `postal_code` | No |
| Country | Country code | `address_country` | No |

- **Billing Address:** Available in `Complete Checkout`. The fields are the same as those listed in the Shipping Address table and are found within the `payment.instruments[x].billing_address` object (where `x` is the `selected_instrument_id`).

## Payment Verification Data

The following fields are available within the `signals` object in the **Complete
Checkout** response.

> [!NOTE]
> **Note:** For the initial MVP, Google Pay does not perform all checks at transaction time, so some fields may return an empty string or `null`. These may become richer over time.

| Signal Name | Description | API Path |
|---|---|---|
| AVS Full Result | Address Verification System (AVS) check result. | `com.google.avs_full_result` |
| CVV Result | Card Verification Value (CVV) check result. | `com.google.cvv_result` |
| Authentication Triggered | Indicates if extra user authentication was performed. | `com.google.authentication_triggered` |
| Authorization Processed With 3DS | Indicates if 3D Secure verification was performed. | `com.google.authorization_processed_with_3ds` |

## Example

The following example shows the structure of the risk signals object for version
`2026-04-08`.

```json
{
  "signals": {
    "com.google.authentication_triggered": "",
    "com.google.authorization_processed_with_3ds": "",
    "com.google.avs_full_result": "",
    "com.google.cvv_result": "",
    "com.google.device_timezone": "America/Los_Angeles",
    "com.google.device_type": "DESKTOP",
    "com.google.ip_address": "2601:646:8600:3360:cce8:3033:4e1f:f6a8",
    "com.google.locale": "en",
    "com.google.session_start_time": "1781883906339",
    "com.google.viewport_height_px": "1991",
    "com.google.viewport_width_px": "2036",
    "dev.ucp.buyer_ip": "2601:646:8600:3360:cce8:3033:4e1f:f6a8",
    "dev.ucp.user_agent": "Mozilla/5.0 (X11; CrOS x86_64 14541.0.0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/149.0.0.0 Safari/537.36"
  }
}
```