Orboni: facts

Last updated:

Orboni is a non-custodial crypto payment gateway for businesses: a hosted payment page, payment links and an API with webhooks, where the buyer pays the merchant's own wallet.

  • Orboni holds no funds and no private keys: the buyer's payment goes to a wallet the merchant controls.

  • On BNB Chain, Base, Polygon, Arbitrum, Optimism, Avalanche, TRON and Ethereum each payment goes to a one-time contract that can send only to the merchant's wallet; the merchant withdraws such payments in batches and pays that transaction's network fee.

  • A payment on those networks must be at least $1; on TRON and Ethereum also at least twice what withdrawing it costs, which is measured every five minutes.

  • 16 networks take payments: Solana, TON, Bitcoin, Litecoin, Dogecoin, Bitcoin Cash, XRP Ledger, Stellar, BNB Chain, Base, Polygon, Arbitrum, Optimism, Avalanche, TRON and Ethereum.

  • Buyers can pay in USDT (9 networks), USDC (9 networks), DAI (on Ethereum, Arbitrum, Optimism and Polygon), PayPal USD (PYUSD, on Ethereum and Arbitrum), BTC, ETH (on Ethereum, Base, Arbitrum and Optimism), BNB, SOL, TON, TRX, POL, AVAX, LTC, DOGE, BCH, XRP and XLM: 40 coin-and-network pairs.

  • On Solana the buyer must pay from a wallet; an exchange withdrawal cannot carry the payment reference.

  • Prices can be set in US dollars or in 36 other currencies: EUR, GBP, CHF, PLN, CZK, HUF, RON, DKK, SEK, NOK, ISK, TRY, JPY, KRW, CNY, HKD, SGD, INR, IDR, MYR, PHP, THB, ILS, AUD, NZD, CAD, MXN, BRL, ZAR, UAH, ARS, CLP, AED, SAR, TWD and VND. Such a price is turned into US dollars once, when the checkout session is made, at the European Central Bank's reference rate of that day (for UAH, ARS, CLP, AED, SAR, TWD and VND, which the ECB does not publish, at the market rate from CoinGecko), and the buyer pays its worth in the coin they pick; fees and invoices stay in US dollars.

  • A price must be worth from $1 to $100,000 per checkout session.

  • The fee is 0.5% of each completed live payment, with no fixed part, no monthly fee and no setup fee; test payments are never billed.

  • The buyer pays the network fee of their own transfer.

  • Fees are invoiced once a month, after the month ends, and paid in crypto within 14 days; an invoice under $1 waits for the next month. Once a past-due notice has been sent, new live checkout sessions can be refused until the invoice is paid.

  • Test mode uses test keys and test networks, or a "Simulate payment" button in the dashboard; no real money moves.

  • Refunds are sent by the merchant from their own wallet; Orboni records them but does not make them.

  • Webhooks are signed with HMAC-SHA256 (the Webhook-Signature header) and retried up to 8 times over about three days.

  • The hosted payment page is available in 85 languages; the website in 15.

  • Orboni does not exchange crypto for fiat money and has no recurring billing. Of ready-made platforms it has plugins for WooCommerce, Easy Digital Downloads, OpenCart (versions 4 and 3) and Magento 2, a payment provider for Odoo (18, 19 and 20) and gateways for FOSSBilling and Blesta (billing for hosting companies) only. It is offered to businesses only, not to consumers.

Product

  • Home — how a payment reaches the merchant's wallet
  • Coins and networks — what works today and what is marked "soon"
  • Pricing — the fee, how it is counted and the monthly invoice
  • How the money moves — where a payment goes on each network; what Orboni can and cannot do
  • FAQ — wallets, exchanges, amounts
  • Sign up — a merchant account

Developer docs

  • Quick start — create a checkout session and send the buyer to it
  • Libraries — the official client libraries: orboni on npm (Node.js, TypeScript), orboni/orboni-php on Packagist, orboni on PyPI; Markdown at /docs/libraries.md
  • Checkout sessions — the API object, its fields and statuses
  • Payment methods — every coin and network, finality times, minimums
  • Withdrawals — moving payments out of the one-time contracts
  • Payment links — a reusable link without code; Markdown at /docs/payment-links.md
  • WooCommerce — the plugin for WooCommerce stores; Markdown at /docs/woocommerce.md
  • Easy Digital Downloads — the plugin for Easy Digital Downloads stores (digital products on WordPress); Markdown at /docs/easy-digital-downloads.md
  • GiveWP — the plugin for GiveWP donation forms (nonprofits on WordPress); Markdown at /docs/givewp.md
  • FOSSBilling — the gateway for FOSSBilling, billing software for hosting companies; Markdown at /docs/fossbilling.md
  • Blesta — the gateway for Blesta, billing software for hosting companies; Markdown at /docs/blesta.md
  • OpenCart — the extension for OpenCart 4 and OpenCart 3 stores; Markdown at /docs/opencart.md
  • Odoo — the payment provider for Odoo 18, 19 and 20: eCommerce checkout, portal orders and invoices, payment links; Markdown at /docs/odoo.md
  • Magento 2 — the module for Magento Open Source and Adobe Commerce 2.4.7 and later; Markdown at /docs/magento.md
  • Payment button — orboni.js on the merchant's own page
  • Refunds — recording a refund sent from the merchant's wallet
  • Webhooks — events, signature check, retries; Markdown at /docs/webhooks.md
  • Testing — test keys, test networks, simulated payments; Markdown at /docs/testing.md
  • Limits — request rates, amounts, sizes
  • OpenAPI document — the whole /v1 API and its webhooks as OpenAPI 3.1, for code generators and API tools

For payers

Legal

llms.txt