Recipe: Payment fraud review queue

Build a human-in-the-loop queue for reviewing flagged transactions before they settle.

Overview

When Meridian flags a payment as high-risk, it lands in a review queue instead of being auto-captured. Your team inspects the signal, decides to approve or void, and Meridian records the outcome for future model training.

Queue schema

{
  "review_id": "rev_9a7b",
  "payment_intent": "pi_3Kx...",
  "amount": 14999,
  "currency": "usd",
  "risk_score": 0.87,
  "flags": ["velocity", "billing_mismatch"],
  "customer_email": "buyer@example.com",
  "created": "2026-01-15T14:22:00Z"
}

Endpoints

GET /v1/reviews/pending — fetch queue items
POST /v1/reviews/{id}/approve — capture payment
POST /v1/reviews/{id}/void — cancel authorization

Reviewer workflow

Poll pending reviews every 30 seconds.
Display risk score, flags, and a link to the customer profile.
Reviewer clicks Approve or Void.
Meridian logs the decision and removes the item from the queue.

Note: Decisions are immutable. Voided payments cannot be re-captured. Always confirm with the customer before voiding.