Conversions & settlement

Understand payzum's crypto-in/crypto-out settlement model and how auto-convert works.

payzum is a crypto-in / crypto-out processor. There is no fiat off-ramp — funds always move between crypto assets. Settlement can happen in the same currency the buyer paid with, or in a different stablecoin after an automatic swap.

Settlement model

When a buyer pays an invoice, the funds are deposited on-chain to a merchant-owned HD-derived address. payzum does not custody these funds. From there, one of two paths applies:

  • Direct payout — the funds stay in the pay currency and are sent to the payout address you configure for that chain.
  • Auto-convert — the received funds are automatically swapped to your chosen stablecoin (e.g. USDC on a specific chain) and forwarded to your stablecoin forwarding address.

If you accept a chain without configuring either a payout address or auto-convert, payzum will refuse new invoices on that chain until the gap is fixed: the payment-creation API returns 400 INVALID_REQUEST with a payout-address-missing message, and the hosted checkout simply does not offer that chain.

Enabling auto-convert

Go to Merchants → [your merchant] → Settings and find the Auto-convert payments to a stablecoin card. Toggle it on, choose your target stablecoin (symbol, chain, token standard), and enter the forwarding address where the converted amount should be sent.

The fee for each swap is expressed in basis points and is shown in the settings card. payzum monetises via the swap spread — there is no separate fiat conversion fee.

Viewing conversions

Go to Merchants → [your merchant] → Conversions to see a paginated list of all swaps triggered for this merchant.

Each row shows:

  • When — timestamp of the swap.
  • Invoice — the invoice that triggered the swap.
  • Status — current swap status (e.g. completed, pending, failed).
  • From — the source token and chain (what the buyer paid with).
  • To — the destination token and chain (your configured stablecoin).
  • Output — the amount of destination token received by your forwarding address.

Settlement currency can differ from the pay currency. A buyer paying in ETH on Ethereum will settle in USDC on Polygon if that is your configured stablecoin — this is handled automatically by the swap provider.

Supported swap providers

Multiple swap providers (0x, LI.FI, Jupiter, SunSwap, and Binance routing) are configured at the platform level. The best route is selected automatically. Provider configuration is managed in the admin panel and does not require merchant action.

What a conversion costs, and when one does not happen

The swap fee is 1% of the payment, or the destination network's real withdrawal cost plus a 10% margin — whichever is larger. The percentage is the normal case; the floor exists because a network fee is a fixed number of dollars and a percentage alone cannot cover it on a small payment.

Above 3%, no conversion happens. If the fee for a route would exceed 3% of the payment, payzum forwards the coin the buyer actually sent, unconverted, to your payout address for that chain. You are never charged a conversion fee for a conversion that did not run — only the 0.5% sale fee applies.

This is why every route has an effective minimum: below a certain payment size the fixed network cost breaches the 3% ceiling and the route stops converting. The exact figure depends on the destination network's live withdrawal cost, so it moves. As a rough guide, Ethereum stops converting below roughly $17 and Tron below roughly $57, while cheap destinations such as Polygon, Base and Arbitrum stay economical far lower.

The settings page shows the current minimum for the destination you have selected, computed from live costs rather than from a table. Trust that figure over the examples above.

Two consequences worth planning for:

  • Configure a payout address for every chain you accept, not just your conversion destination. A payment that falls below its route's minimum is forwarded in the source coin, and without an address on that chain payzum has nowhere to send it — the invoice will be refused at creation instead.
  • Small payments may settle in mixed currencies. A $5 sale on Ethereum and a $500 sale on Ethereum can settle differently: the first forwarded as ETH, the second converted to your stablecoin.

Point of sale

A POS charge is quoted in fiat at a register, so accepting a coin whose price moves is opt-in per merchant. With it off, terminals take stablecoins only.

With it on, a volatile POS sale carries a 0.5% buffer on top of the price — half the rate used elsewhere, because a POS sale settles in seconds rather than over a cross-chain window — plus the usual 0.5% sale fee. Converting POS takings to your stablecoin is a separate checkbox and adds the 1% swap fee; it is independent of the auto-convert setting for your online sales.

Enabling volatile coins does not make slow chains fast. A Bitcoin payment still needs a confirmation, which can take 10 to 60 minutes — a long time with a customer waiting. For a register, prefer coins that confirm in seconds.