Feature · Internal Transfers ▓ OFF-CHAIN · ATOMIC · IDEMPOTENT Zero network fees

Transfers
without a chain.

POST /v1/transfer moves balance between any two OrbChain accounts by account ID. No broadcast, no confirmations, no network fee — one atomic ledger transaction that either fully happens or fully doesn't. Both sides get an HMAC-signed webhook.

Create account → Read the spec

Instant · Atomic · Both-sides notified

§ Part I / IV · The contract

What we promise.

Every guarantee
Ledger semantics, not chain semantics

SymGuaranteeHowStatus

0-FEEZero network feeNothing touches a blockchain. The transfer is a balance move inside OrbChain's ledger — no gas, no miner fee, no dust.ALWAYS

ATOMAtomicDebit and credit run in one database transaction. There is no state where the sender is debited and the recipient isn't credited.GUARANTEED

INSTInstantNo confirmations to wait for. The recipient's balance is spendable — payout, swap, or re-transfer — the moment the call returns.ALWAYS

IDEMIdempotentPass idempotency_key (body or X-Idempotency-Key header). Retry the same call forever; the transfer happens once.RECOMMENDED

2FATOTP step-upAccounts with 2FA enabled must pass totp_code on every transfer — a leaked API key alone can't move your balance.ENFORCED

WHBoth sides notifiedtransfer.sent to the sender, transfer.received to the recipient. HMAC-SHA512 signed, deterministic event IDs, 5 retries.SIGNED

§ Part II / IV · The call

One request.
Done.

Recipient = account ID
Shown on every dashboard

POST /v1/transfermerchant_api_key · scope transfer:create

{
  "to_account_id":   "ORB-8fQzX2mK4vNc7RwHt3Yp",  // recipient's public account ID
  "coin":            "USDT_TRC20",
  "amount":          "250.00",
  "idempotency_key": "payrun-2026-08-17-alice",
  "totp_code":       "492013"              // required when 2FA is enabled
}

// 200 — recipient balance already spendable
{
  "transfer_id":   "tr_01JR5M2K8Q",
  "to_account_id": "ORB-8fQzX2mK4vNc7RwHt3Yp",
  "coin":          "USDT_TRC20",
  "amount":        "250.00",
  "created_at":    1786958400
}

§ Part III / IV · What it's for

Closed loops
beat open chains.

Common shapes
All zero-fee

SymPatternHow it runs on transfersChain fees

NETPartner networksYour affiliates, sub-operators, or resellers each hold an OrbChain account. Settle commissions internally the moment they accrue; partners withdraw on their own schedule via the payout API.$0.00

MKTMarketplace sellersBuyers pay you once; you distribute seller shares as internal transfers. No per-seller on-chain payout until the seller actually cashes out.$0.00

TRSTreasury movesRun separate accounts per business line and rebalance between them instantly — bookkeeping-clean, each with its own API keys, webhooks and statement.$0.00

B2BSupplier settlementPay any vendor who also runs on OrbChain by account ID — instant finality, idempotent retries, and both parties get a signed webhook record.$0.00

§ Part IV / IV · Questions

Things integrators
ask first.

Short answers
Links to code

Q.01Where does the recipient find their account ID?

Every account gets a public ORB-… ID at signup, shown on the dashboard header and /dashboard/account. It's safe to share — it can only receive.

Q.02Is a transfer reversible?

No — like a chain payment, it's final once it settles (which is immediately). Unlike a chain payment, a wrong retry can't double-send: use idempotency_key and repeats are no-ops. The recipient can always transfer back.

Q.03Which coins can I transfer?

Any coin you hold a balance in — the transfer moves ledger balance, so every deposit coin on the platform works, including Lightning-credited BTC.

Q.04How does the recipient cash out?

Their balance behaves like any other: withdraw via POST /v1/payout, set an auto-payout threshold, or convert with Auto Settle.

Q.05Can I do this from the dashboard instead of the API?

Yes — the Transfers tab has the same form (recipient ID, coin, amount) with the same TOTP step-up, plus your full sent/received history.

Stop paying gas
to move your own money.

Internal transfers are instant, atomic, and free — on every OrbChain account, today.

Create account → Full spec

Transfers without a chain.

What we promise.

One request.Done.

Closed loopsbeat open chains.

Things integratorsask first.

Stop paying gasto move your own money.

Transfers
without a chain.

One request.
Done.

Closed loops
beat open chains.

Things integrators
ask first.

Stop paying gas
to move your own money.