DocsAPI ReferenceAI Payments Map

The payment decision layer

Between the moment a payment is proposed and the moment money actually leaves, something has to decide whether the transaction should be allowed at all. Historically that decision was often embedded inside other products — an AP system, a bank, a fraud tool, or an internal automation. As initiation becomes more automated and more varied, it makes increasing sense to treat this step as a layer in its own right.

Definition

A payment decision layer is a system that sits between initiation and execution. It evaluates the payment request together with additional context, applies policy, and returns a final decision on every request while preserving a record that can be used for audit.

This map uses four outcomes:

A decision layer may also return reason codes, policy-version pointers, and signed decision receipts.

What it is not

Typical inputs

Typical outputs

Why this layer is becoming visible now

When initiation mostly came from humans inside specialized tools, the decision logic could stay hidden inside those tools. When requests come from agents, automated workflows, ERP runs, API calls, and protocols, a common decision interface becomes easier to justify.

Several adjacent developments — mandate concepts in network protocols, the argument for separating decisioning from execution in architecture, and new agent-identity schemes — are inputs this layer consumes. They are not the layer itself.

Where Froddy fits

Froddy belongs to this layer: it sits before payment execution, applies policy to the request, and returns one of four outcomes with a reason code and an audit record. Execution, routing, and movement of funds remain in the client's existing infrastructure.

Related pages

Change log