API Reference

Verify a device for a user account

post
https://example.com/programs//deviceVerification

Verifies a device for a user account using device fingerprint, event type, and other metadata.

Path Params
string
required

The program code identifying the BaaS program context.

Body Params

The request payload containing device verification details.

  • EventType: The type of device verification event.

  • BlackBox: The device fingerprint or black box data.

  • EndUserIpAddress: The IP address of the end user.

  • AccountIdentifier: The account identifier (optional).

  • UserIdentifier: The user identifier (optional).

  • TransferIdentifier: The transfer identifier (optional).

  • DeviceSessionToken: The device session token (optional).

Represents a request for device verification.
Contains event type, device/session details, user/account identifiers, and context information.
Inherits standard request metadata from Gd.Bos.DataTransfer.Request.RequestBase.

string
enum
required

The event type for device verification (e.g., GuestCheckOut, Enrollment, Login, PreLoginCardActivation).
Uses Gd.Bos.DataTransfer.Enums.DeviceVerificationEventType to specify the verification scenario.

Allowed:
string
required
length ≥ 1

The black box data containing device fingerprint or risk assessment payload.

string
required
length ≥ 1

The IP address of the end user initiating the device verification.

string | null

The unique identifier for the account associated with the device verification.

string | null

The unique identifier for the user associated with the device verification.

string | null

The unique identifier for the transfer associated with the device verification, if applicable.

string | null

The session token for the device, used to correlate device sessions.

Headers
string
required

A unique request identifier for tracking and logging. Should be a GUID.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
string
enum
Defaults to application/json-patch+json

Generated from available request content types

Allowed:
Responses

401

Unauthorized

Updated 6 months ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json
text/json

Updated 6 months ago

Did this page help you?