Node.js SDK Guide

npm install axios

import axios from 'axios';
import crypto from 'crypto';

const BASE_URL = 'https://api.vertexY.com/api';

export class VertexYClient {
  constructor({ companyId, accessToken, webhookSecret }) {
    this.companyId = companyId;
    this.accessToken = accessToken;
    this.webhookSecret = webhookSecret;
    this.http = axios.create({
      baseURL: BASE_URL,
      headers: {
        Authorization: `Bearer ${accessToken}`,
        'Content-Type': 'application/json',
      },
    });
  }

  async assess(payload) {
    const { data } = await this.http.post('/risk-engine/assess', payload);
    return data;
  }

  async submitFeedback(payload) {
    const { data } = await this.http.post('/risk-engine/feedback', payload);
    return data;
  }

  async listPublicPlans() {
    const { data } = await this.http.get('/subscriptions/me');
    return data;
  }

  async ingestEvent(event) {
    const body = JSON.stringify({
      ...event,
      companyId: this.companyId,
    });
    const timestamp = String(Math.floor(Date.now() / 1000));
    const nonce = crypto.randomUUID();
    const signature = crypto
      .createHmac('sha256', this.webhookSecret)
      .update(body)
      .digest('hex');

    const { data } = await axios.post(`${BASE_URL}/events/ingest`, body, {
      headers: {
        'Content-Type': 'application/json',
        'x-event-signature': signature,
        'x-event-timestamp': timestamp,
        'x-event-nonce': nonce,
      },
    });

    return data;
  }
}

import { VertexYClient } from './vertexy-client.js';

const client = new VertexYClient({
  companyId: process.env.VERTEXY_COMPANY_ID,
  accessToken: process.env.VERTEXY_ACCESS_TOKEN,
  webhookSecret: process.env.VERTEXY_WEBHOOK_SECRET,
});

const assessment = await client.assess({
  transactionId: 'txn_100001',
  userId: 'user_123',
  amountMinor: 4999,
  currency: 'USD',
  email: 'buyer@example.com',
  ipAddress: '203.0.113.10',
});

console.log(assessment.action);
console.log(assessment.riskScore);

await client.ingestEvent({
  eventSource: 'checkout-service',
  externalEventId: 'evt_100001',
  idempotencyKey: 'evt_100001',
  userId: 'user_123',
  eventType: 'payment_succeeded',
  timestamp: new Date().toISOString(),
  metadata: {
    email: 'buyer@example.com',
    ipAddress: '203.0.113.10',
    deviceId: 'device_abc_001',
  },
});

export VERTEXY_COMPANY_ID="..."
export VERTEXY_ACCESS_TOKEN="..."
export VERTEXY_WEBHOOK_SECRET="..."