Papillae Docs

The Product

What it does

How the Papillae payment engine routes, simulates, executes, and learns.

Updated Feb 23, 2026

What It Does Most payment infrastructure is a wrapper. Someone built a UI on top of Stripe, or wired together a few APIs, called it a product and shipped it. The routing logic is static. The fees are fixed. The fallbacks either do not exist or are an afterthought. When something breaks mid-transfer, a human has to intervene.

Papillae's payment engine is not a wrapper. It is the thing underneath. It is a real-time routing and execution system that treats every payment as a fresh problem to solve. It does not look up a static table and say "for Nigeria we use partner X." It evaluates every available path at the moment the payment arrives, scores them against live performance data, simulates the winning route before touching real funds, executes atomically through on-chain contracts, monitors every hop, re-routes if anything fails, and delivers. Then it writes what it learned back to the telemetry layer so the next payment on that corridor is routed with better data.

The result from the outside looks simple. You send an instruction. Money arrives on the other end. Under that simplicity is a system that made dozens of real-time decisions on your behalf.


Here is what the engine handles so you do not have to think about it.

Route computation. Every transfer, every time, the engine evaluates available bridges, swap protocols, and off-ramp partners against live cost, latency, and success rate data. It does not assume yesterday's best route is still the best route today.

Pre-flight simulation. Before a single token moves, the engine dry-runs the entire route. Checks liquidity depth at the exact amount. Estimates real slippage, not theoretical. Pings the off-ramp partner to confirm they are accepting transfers to that corridor right now. If simulation fails, nothing moves. You get an explanation.

Atomic execution. Funds flow through Papillae's smart contracts. Every hop in a multi-hop route is coordinated as a single execution context. If hop two of three fails, the contract does not leave your funds stranded on a bridge. It re-routes from that exact point using a pre-computed fallback.

Settlement verification. The engine does not fire a success event when it submits a transaction. It fires a success event when it has confirmed arrival at the destination. These are different things and most systems confuse them.

Telemetry recording. Every transfer writes back. Actual fee versus estimated. Actual time versus estimated. Which protocol was used. Whether it succeeded. Over thousands of transfers this builds a proprietary corridor intelligence dataset that improves every subsequent routing decision.