Integrations

Drop into the stack you already run

Riskgrove connects to your existing payment gateway via REST. No rerouting, no middleware layer. Send us a scoring request before each auth call.

integration_type REST API (single endpoint)

sdk_languages Node, Python, Go, Ruby, PHP, Java

gateway_adapters 8 native, any via direct API

webhook_events score, review, chargeback, feedback

SDKs

Native client libraries

All SDKs wrap the same REST API. Choose the one that matches your application runtime.

Node.js

GA 1.2

Python

GA 1.2

GA 1.1

Ruby

GA 1.0

PHP

GA 1.0

Java

Beta

REST (direct)

Always available

Webhooks

HTTPS POST

Node.js quickstart

// npm install @riskgrove/node
const Riskgrove = require('@riskgrove/node');

const client = new Riskgrove({ apiKey: process.env.RGV_API_KEY });

const result = await client.score({
  transaction_id: 'txn_9X2k4m',
  amount_cents: 8500,
  currency: 'USD',
  card_fingerprint: 'fp_7vQn2w',
  device_id: 'dv_3kLp9s',
  user_id: 'usr_4mRt1q',
  ip_address: '203.0.113.42',
});

// result.score: 0.07 (low risk)
// result.recommendation: "approve"
// result.signals: [...]

Payment Gateways

Native gateway adapters

These adapters handle the signal extraction from your gateway's webhook or pre-auth event. Your transaction flow stays unchanged.

Stripe

payment_intent.created webhook

Adyen

pre-auth webhook notification

Braintree

transaction.created webhook

Checkout.com

payment_pending event

Worldpay

authorization request listener

Marqeta

JIT funding gateway

Galileo

transaction authorization event

Any PSP via REST

direct POST /v1/score call

API Reference

One endpoint for all scoring modules

The scoring API is a single POST endpoint. The response includes a composite risk score (0.00-1.00), a recommendation, and the contributing signals from each active module.

Required fields

transaction_id: unique ID for this transaction
amount_cents: transaction amount in smallest currency unit
currency: ISO 4217 currency code
card_fingerprint: card identifier (not PAN)
device_id: device fingerprint from your client SDK

Response fields

score: composite risk score, 0.00 (safe) to 1.00 (high risk)
recommendation: approve / review / block
signals: top contributing factors array
latency_ms: server-side evaluation time
request_id: idempotency key for this score call

Full API reference

Questions about your stack?

Talk to us before you build

We'll review your payment infrastructure and confirm the right integration path before you write a line of code.

Get a demo Read the docs