Block Rules & Fraud Prevention

Block rules stop checkouts and payments from matching IPs, emails, PAN/BIN patterns, specific customers, or payment IDs. Rules use an AND / OR operator across the criteria you set.

Create a block rule

await tagada.blockRules.create({
  name: 'Temp BIN + email pattern',
  operator: 'OR',
  bin: '424242',
  emailRegex: '.*@disposable\\.example',
  isPermanent: false,
  ttlHours: 24,
});

Use OR when any single signal should block; use AND when all filled criteria must match.

Rule criteria reference

Field	Matches
`ipAddress`	Exact IPv4/IPv6
`email`	Exact email
`emailRegex`	Email pattern (regex string)
`bin`	Card BIN (typically 6 digits)
`binRegex`	BIN pattern
`pan`	Full or partial PAN (exact)
`panRegex`	PAN pattern
`customerId`	Specific customer ID
`paymentId`	Specific payment ID

Additional flags include autoCreated, metadata, isPermanent, and ttlHours.

Temporary vs permanent blocks

// Expires after 24 hours
await tagada.blockRules.create({
  name: 'Cooling off',
  operator: 'OR',
  ipAddress: '203.0.113.10',
  isPermanent: false,
  ttlHours: 24,
});

// No expiry
await tagada.blockRules.create({
  name: 'Permanent email block',
  operator: 'OR',
  email: 'abuse@example.com',
  isPermanent: true,
});

ttlHours is only meaningful when isPermanent is false. Allowed range is 1–8760 hours.

List, retrieve, update, delete

const list = await tagada.blockRules.list();

const rule = await tagada.blockRules.retrieve('rule_...');

const updated = await tagada.blockRules.update('rule_...', {
  data: {
    name: 'Renamed rule',
    emailRegex: '.*@spam\\.test',
  },
});

await tagada.blockRules.del('rule_...');

The list endpoint accepts pagination and filters via the HTTP API (pagination, sortBy, filters); the SDK currently posts an empty body for list() — extend the call if you pass a typed body through your integration.

SDK methods reference

Method	Description
`tagada.blockRules.list()`	List rules for the authenticated account
`tagada.blockRules.create(params)`	Create a rule (`BlockRuleFormSchema`-shaped fields)
`tagada.blockRules.retrieve(id)`	Fetch one rule
`tagada.blockRules.update(id, { data })`	Partial update (`data` uses the same fields as create)
`tagada.blockRules.del(id)`	Delete a rule

Next steps

Payments

Process and route payments after hardening with block rules

Customer management

Tie blocks to customerId and customer-level review

Checkout sessions

Share checkout links and monitor async payment status

Funnel orchestrator

Routing and conditions alongside fraud controls

Customer Management Processor Credentials

Overview

Web Integration

Tracking & Attribution

Node SDK

Funnels

Shopify

SaaS Billing

Headless SDK

Plugin SDK

Plugin CLI

Studio MCP (AI Agents)

CRM MCP (AI Agents)

Hosting & A/B Testing

Internal

Block Rules & Fraud Prevention

Block Rules & Fraud Prevention

Create a block rule

Rule criteria reference

Temporary vs permanent blocks

List, retrieve, update, delete

SDK methods reference

Next steps

Payments

Customer management

Checkout sessions

Funnel orchestrator

​Block Rules & Fraud Prevention

​Create a block rule

​Rule criteria reference

​Temporary vs permanent blocks

​List, retrieve, update, delete

​SDK methods reference

​Next steps

Payments

Customer management

Checkout sessions

Funnel orchestrator

Block Rules & Fraud Prevention

Create a block rule

Rule criteria reference

Temporary vs permanent blocks

List, retrieve, update, delete

SDK methods reference

Next steps