Help Center

When a payment routes to a payment service provider (PSP) that runs native fraud detection, the PSP expects a device session or fingerprint ID collected by its fraud SDK on the checkout page. Pass this data in the device_sessions array so Solidgate can forward it to the matching connector during authorization.

Load the PSP fraud SDK on your checkout page, capture the session or fingerprint ID it returns, and include it in the payment request with the provider value.

Pass device_sessions in

• card payment API requests
• paymentIntent object Payment Form
• resignIntent object Resign Form

The id value comes from the PSP SDK, not from your application order ID. For example, Checkout Risk.js returns a device fingerprint, and Airwallex device fingerprinting uses the data-order-session-id value from its script.

Supported provider values

• checkout Checkout Risk.js Reference device fingerprint
• airwallex Airwallex device fingerprint Reference script session ID

Description

Device sessions containing the unique session ID from a PSP fraud SDK and the associated third-party provider.

Description

Unique session or fingerprint identifier returned by a PSP fraud SDK.

Parameter for tracking customer sessions in payments and for risk analytics. Ensure that you handle this field in compliance with regional data privacy regulations (for example, GDPR Reference in the EU).

Example

dsid_3a20_f9c1_4cd8_89d3_1c5

Description

Specifies the third-party provider associated with the device session.

Identifies the PSP:

• checkout
• airwallex

Example

checkout

"device_sessions": [
  {
    "id": "dsid_3a20_f9c1_4cd8_89d3_1c5",
    "provider": "checkout"
  },
  {
    "id": "a0d24c8a-2b67-4b4b-bd39-d2efbe92a7f0",
    "provider": "airwallex"
  }
]