Introducing VIDA Identity Stack: All of VIDA, in one place 🎉
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Submit Data

submitData is an asynchronous method that returns a Promise. It sends the current fraud-shield signals for evaluation and submits them with your transaction context.

It returns a successful response from VIDA when submission is completed, including server response details for that request. If submission cannot be completed, it throws an error and triggers the configured onError callback from initialization.

async function submitFraudShieldData() {
  try {
    const response = await VidaIdFraudShield.submitData({
      clientTransactionId: 'a9bab349-8e80-43b8-8c40-3fc946e389ew', /* your trx id */
      token: 'YOUR TOKEN',
      signingKey: 'YOUR SIGNING KEY',
    });
    console.log('submitData success:', response);
  } catch (error) {
    console.error('submitData failed:', error);
  }

Parameters

Parameter
Type
Required
Description

clientTransactionId

string

Yes

This is your transactionID for the specific flow, this will also be used by customer to fetch the fraud details from VIDA backend

token

string

Yes

The bearer token obtained from Vida SSO. Used for authentication.

signingKey

string

Yes

The signing key shared by Vida. Required for secure submission of data.

Last updated