Appearance
Buy crypto
The Buy Crypto pop-up lets users buy crypto with a bank card, or sell crypto for fiat, through Unlimit (formerly GateFi). The card payment happens on Unlimit's checkout, and the coins arrive like a normal deposit.
When it appears
The pop-up exists only when UNLIMIT_ENABLED=true in .env. Users open it from Buy Crypto in the top menu. With it off, the menu item is hidden and the pop-up isn't loaded.
Users must be signed in ("Log in to continue") and identity-verified (KYC). Unverified users are refused.
Buying
The Buy tab:
| Field | Meaning |
|---|---|
| You pay | Amount and fiat currency (default UNLIMIT_DEFAULT_BASE_PAIR, USD) |
| You receive | The coin (default UNLIMIT_DEFAULT_QUOTE_PAIR, USDT) and the estimated amount |
| Exchange Rate, Processing Fee, Network Fee | Unlimit's live quote |
| We accept | The card types |
Buy sends the user to Unlimit's checkout to pay. Unlimit sends the coins to the user's own deposit address on the platform (created if needed). The platform then detects and credits them like any crypto deposit, into the Funding Account.
Selling
The Sell tab: You sell (coin and amount), the fiat to receive, and the Payout Method. Sell continues on Unlimit's checkout, where the user sends the coins and receives the payout.
Which coins and currencies
The lists come from your Unlimit account and are refreshed every 15 minutes (unlimit:sync-config), or at once with the sync button in Settings → Unlimit. A coin only appears if it also exists on your exchange. If Unlimit has no quote for a combination, the rate shows N/A.
Setting it up
- Open a partner account with Unlimit and get your partner account ID, access key and secret key.
- Enter them in Admin → Settings → Unlimit, together with the API base URL. The default,
https://api-sandbox.gatefi.com, is Unlimit's sandbox. Use the live address they give you for real payments. - Set
UNLIMIT_ENABLED=truein.envand runphp artisan config:clear. - Optional:
UNLIMIT_DEFAULT_BASE_PAIR/UNLIMIT_DEFAULT_QUOTE_PAIRfor the pre-selected currencies, andUNLIMIT_REDIRECT_URLfor where users return after paying (your site by default). - Make sure the deposit networks of the coins you sell are working (Bridges), because purchases arrive as deposits.
Test in the sandbox first
Keep the sandbox URL until a test purchase has arrived in a test account's Funding wallet.
