Simplex - Fiat On-Ramp
The Simplex plugin adds a Credit card page to your exchange. Users get a quote and pay by card on Simplex's checkout, and Simplex sends the crypto to their deposit address on your exchange. Your exchange never handles fiat.
What you need
- The Enterprise plan on HollaEx Cloud.
- A Simplex partner account, with an API key and your partner name from Simplex.
- The coins you want to offer listed on your exchange.
The Guardarian plugin uses the same /credit-card page. Install Simplex or Guardarian, not both.
Set it up
- Get your API key and partner name from Simplex.
- Install simplex from Operator Controls → Exchange → Plugins.
- Open the plugin, enter the settings below and save. Use the sandbox addresses first to test.
- Sign in to your exchange as a test user, open Credit card and request a quote.
- When you're ready to go live, switch both Simplex addresses to production.
| Setting | What it does |
|---|---|
| api_key | Secret, from Simplex. Your Simplex API key. Required. |
| partner_name | Your partner name, exactly as Simplex gives it to you. Required. |
| simplex_url | Simplex's API address. Sandbox: https://sandbox.test-simplexcc.com. Production: https://backend-wallet-api.simplexcc.com |
| simplex_action_url | Simplex's checkout address. Sandbox: https://sandbox.test-simplexcc.com/payments/new. Production: https://checkout.simplexcc.com/payments/new |
| currencies | The fiat currencies to offer, comma separated with no spaces. Default usd,eur. |
| coins | The coins users can buy, comma separated with no spaces. Default btc,eth,usdt,trx. Each one must also be listed on your exchange. |
Until api_key, partner_name and simplex_url are set, the plugin keeps trying again once a minute.
What your users see
The Credit card page (titled Buy with Credit Card) appears in your exchange's navigation. The user picks the fiat currency and the coin, enters an amount and sees a quote. Before leaving your exchange, the user accepts a disclaimer saying that Simplex, a third party, handles the card payment. They then pay on Simplex's checkout and return to your exchange.
The page buys crypto only.
How it works
- The crypto goes to the user's own deposit address on your exchange for that coin. If the user doesn't have one yet, the plugin creates it.
- Simplex sends the crypto on-chain, and it's credited like any other deposit. The plugin doesn't credit anything itself.
- Every minute, the plugin reads and clears the queue of events Simplex keeps for your account.
- Simplex handles the card payment and its own identity checks. For problems with an order, users contact Simplex.
Troubleshooting
- A coin doesn't appear or the quote fails: check that the coin is in the
coinssetting and listed on your exchange, and that Simplex supports it for your account. - "Payment request failed": Simplex didn't accept the payment request. Check your partner name and API key, and that you're using matching sandbox or production addresses.
Need help? Open a ticket from your HollaEx dashboard.