Docs Open Console

Gemini

Connect your Gemini exchange account for three post-settlement superpowers: fresh deposit addresses, instant fiat conversion, and automatic sweeps.

What the Gemini connection does#

Gemini is an exchange integration, not a checkout rail - buyers never see it. It works on your crypto after it arrives, via Gemini's private API (your keys are stored encrypted):

FeatureWhat happens
Address generationWhen a coin has no static address of yours on file, U.CASH mints a fresh Gemini deposit address per checkout and watches it
Instant conversionOn settlement, the coin is market-sold on Gemini into your chosen fiat (or GUSD) immediately
TransferOn settlement, the coin is swept from Gemini to the receive address you configured

Conversion and transfer are mutually exclusive - enable one or the other per coin. Conversion sells immediately at market; transfer keeps you in crypto while moving funds to your own wallet.

Setup#

  1. Create an API key in your Gemini account (self-hosted builds: enable the sandbox flag to test with Gemini's sandbox)
  2. Open Settings → Exchange Integration (requires the wallets permission)
  3. Paste the API key and API secret
  4. Enable the features you want: address generation, conversion (pick the target: USD, EUR, GBP, AUD, SGD, HKD, or GUSD), or transfer

Exchange integration is available on self-hosted and white-label deployments.

Good to know

  • Conversion places a limit sell just under the live market price and retries until it fills - you trade off a sliver of spread for immediacy
  • Address generation only kicks in for coins with no static address configured; if you set explicit addresses in Settings → Addresses, those always win (true non-custodial)
  • You will get an email whenever a conversion or sweep succeeds or fails (see the notifications settings)
  • Two exchange integrations can coexist: if Gemini fails, Coinbase can act as fallback for conversion and transfer