Stellar Path Payments

Definition: A Stellar path payment sends one asset from the source account and delivers a different asset to the destination account. The conversion can route through available offers on the Stellar Decentralized Exchange (SDEX) and/or Stellar liquidity pools.

Protocol documentation Path payments documentation
Directories Stellar Ecosystem Directory

Two operation types

Path Payment Strict Send fixes the amount and asset sent; the amount received can vary, subject to a minimum-output limit. Path Payment Strict Receive fixes the amount and asset the destination must receive; the amount sent can vary, subject to a maximum-input limit. These bounds help a transaction fail instead of executing outside the user’s stated terms.

How a route is found

A path may involve several asset conversions. It succeeds only when a viable route exists through order-book offers or liquidity pools and the destination can receive the resulting asset. If liquidity is missing, the route is no longer viable, or the destination account lacks the needed trustline for an issued asset, the operation can fail.

A Stellar payment, not a cross-chain bridge

Path payments convert among assets available on Stellar and settle to an account on Stellar. They do not, by themselves, move funds to another blockchain. A user still needs to check the selected asset and issuer, the stated minimum or maximum, route liquidity, and the transaction details before signing.

Risks and limits

Minimum-output and maximum-input values constrain the transaction but do not guarantee a good market price, deep liquidity, or a safe issuer. Routes and available liquidity can change between quote and submission. Applications should display the source asset, destination asset, route, amount bounds, and failure outcome clearly.

Related Terms

See Also

Sources