Sign in

v1

latestOpenAPI 3.0.12026-07-243407211.3 MB
DeviceVerification

Verify a device for a user account

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

post/programs/{programCode}/deviceVerification

Path parameters

programCodestring required

The program code identifying the BaaS program context.

Headers

X-GD-RequestIdstring required

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

Request body

eventType'GuestCheckOut' | 'Enrollment' | 'Login' | 'PreLoginCardActivation' required

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

blackBoxstring required

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

endUserIpAddressstring required

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

accountIdentifierstring nullable

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

userIdentifierstring nullable

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

transferIdentifierstring nullable

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

deviceSessionTokenstring nullable

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

Response

OK

deviceVerificationRequestKeyinteger nullable

The unique key identifying the device verification request.