AutoStable

AutoStable is an optional settlement feature that automatically converts volatile token payments (ckBTC, ckETH, ICP) into a stablecoin of your choice as each payment settles.

Stablecoins (ckUSDC, ckUSDT) are always received as-is and are never touched by AutoStable.

What AutoStable does

When a buyer pays with a volatile token and AutoStable is enabled for that token, Pybara executes an on-chain swap and delivers a stablecoin to your payout wallet instead. The swap happens automatically with no manual steps on your end.

Requirements

• Pybara Wallet must be your payout wallet. AutoStable is available only to merchants receiving payments into Pybara Wallet.
• One-time per-token approval. The first time you enable AutoStable for a token, Pybara requests a standing ICRC-2 allowance from your wallet. This is a one-time on-chain action per token. Under $0.10 worth of that token needs to be present in your wallet to cover the ledger fee for the approval — only this fee is consumed, not the approval amount itself.

To revoke an approval, set the token back to Hold and save. The plugin will prompt you to confirm the on-chain revocation.

---

Cost

AutoStable charges 1% of the converted amount, on top of the swap cost charged by the DEX.

• The AutoStable fee is separate from your platform (commission) fee.
• The swap cost depends on market conditions at the time of each settlement.
• You are charged the cost actually incurred, never the cap you set.
• If a swap is skipped due to the cost cap (see below), no AutoStable fee is charged.

---

Capping the cost

You set a maximum total cost you are willing to pay for a conversion, covering both the swap cost and the 1% AutoStable fee. Available caps: 2%, 3%, 4%, 5%. The default is 3%.

If the cost would exceed your cap:

• The swap is skipped entirely.
• You receive the original volatile token in full, with no AutoStable fee charged.
• An optional email notification is sent (see below).

How the cap is enforced

The cost is checked twice, independently: once when the conversion is initiated, and again at the moment of execution.

A DEX executes against a live pool, so the final cost of a swap can differ from the cost measured immediately beforehand — another trade landing in the same pool moves the price. To make sure that movement can never push you past your cap, a margin equal to the DEX slippage tolerance is reserved against your cap at both checks.

The effect is a hard guarantee: if your cap is 3%, the cost of a conversion you receive will never exceed 3%, whatever the market does between the check and the swap.

Why a swap can be skipped below your cap

Because the margin is reserved at both checks, a conversion costing slightly less than your cap may still be skipped. A swap estimated at 2.8% against a 3% cap will not go through — at execution it could have landed above 3%, and the guarantee holds instead.

The slippage tolerance is currently 0.3% (30 basis points). It is an internal parameter of the conversion service and is not configurable per merchant.

The 2% cap is restrictive

At a 2% cap, the 1% AutoStable fee, the DEX pool fee, and the reserved slippage margin leave very little headroom. Most conversions will be skipped. Choose 2% only if you would genuinely rather hold the volatile token than convert it at anything above that cost.

---

Skip notifications

When a swap is skipped, Pybara can send you an email alert.

Enable the Send me an email if skipped toggle and enter an address. The notification includes the token, the payment amount, and the reason the swap was skipped.

This setting is optional and applies to your store as a whole, not to individual tokens.

---

Receive as

When a swap executes, you choose which stablecoin you receive:

• Best quote (default) — Pybara routes to whichever of ckUSDC or ckUSDT offers the better rate at the time of settlement.
• ckUSDC — always settle to ckUSDC.
• ckUSDT — always settle to ckUSDT.

Best quote gives a conversion the best chance of landing under your cap, since it takes whichever of the two stablecoins is cheaper to reach at that moment.

---

Where to see the cost

Every conversion is itemised against its order in Pybara Wallet: the token converted, the token received, the swap cost, and the AutoStable fee.