Skip to main content
Back to challenges
Challenge

Type-Safe Debit Processing & Fee Optimization Agent with Pydantic AI

Regulatory debit interchange cap changes are driving banks to dynamically re-route card transactions across competing processing networks. Build a type-safe debit processing agent using Pydantic AI to validate network rules and calculate optimal fee structures with 100% data validation compliance.

CybersecurityHosted by Vera
Sign in free to start
Challenge brief

What you are building

The core problem, expected build, and operating context for this challenge.

Construct a type-safe agent system using Pydantic AI that enforces schema validation on incoming merchant debit requests and selects optimal networks to minimize fees.

Delivery guide

How work is evaluated

Evaluation

Evaluates Pydantic schema validation accuracy and cost optimization performance for debit processing.

Datasets

Challenge datasets

Public datasets, plus the private datasets you have access to.

Evaluation rubric

How submissions are scored

These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.

Dimensions
2 scoring checks
Binary
2 pass or fail dimensions
Ordinal
0 scaled dimensions
Dimension 1

Strict Type Validation

Output must pass Pydantic schema validation with zero runtime validation errors.

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Dimension 2

fee_reduction_pct

Average fee savings versus default network selection • target: 0.2 • range: 0.1-0.3

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Learning goals

What you should walk away with

  • Implement Pydantic AI agent dependencies and dynamic system prompts

  • Define strict Pydantic model response types for transaction routing decisions

  • Build unit test suites validating zero runtime type-coercion errors during high-volume spikes

Resources and assets

Reference links and supporting material

Dataset notes

Synthetic debit interchange fee schedule dataset across 6 major US debit networks and 1,000 test transactions.

Challenge setup

Evaluates Pydantic schema validation accuracy and cost optimization performance for debit processing.

Challenge input

JSON debit authorization request object

Pydantic AI

Assigned agentic framework focusing on Pydantic type safety.

Evaluated output

Validated Pydantic object with network Choice, fee calculated, and compliance certificate

Evaluation checks
  • Output must pass Pydantic schema validation with zero runtime validation errors.
  • Average fee savings versus default network selection • target: 0.2 • range: 0.1-0.3
Configured evaluation evidence
  • Benchmark: TypeSafeFin-Bench
  • Fee Reduction Pct target: 0.2
  • 1 public reference case
Configured runtime
  • Python execution harness
  • Python sandbox (unavailable on Versalist)

Summary shows the first task, up to three tools, and up to three evidence items. Open the technical recipe to view all configured items.

View technical recipe

Configured tools

Action Space
  • Pydantic AI · Required
Orchestration
  • Pydantic AI · Required

Evaluation contract

  • Strict Type Validation · Weight 1
  • fee_reduction_pct · Weight 1

Metrics

  • fee_reduction_pct · Target 0.2

Benchmarks

  • TypeSafeFin-Bench
  • general

Reference cases

  • 1 public reference case

Workflow tasks

  1. Task 1

    Input: JSON debit authorization request object

    Output: Validated Pydantic object with network Choice, fee calculated, and compliance certificate

    Execution harness: Python

Evaluation tools

  • Pydantic AI · Type-Safe Agent Framework

Recipe freeze marker

No recipe freeze time is recorded.

Frequently Asked Questions about Type-Safe Debit Processing & Fee Optimization Agent with Pydantic AI