# Simplex Config

## Introduction of Simplex

Simplex is a financial institution that get the certification from EU and tier 1 service provider, provide intact currency basic equipment for crypt industry. Nuvei who is leading payment technical provider around the world acquired Simplex, provide the strong financial solution for partners so that all people can get cryptocurrency easily.

Currently, lots of famous exchanges such as **Binance, Huobi, Okex, Kucoin, Gateio, Bybit, Trust, Trezor**, and wallet are all using Simplex as solution for depositing currency.

##

## Application Process

### Step 1: Contact with BD of Smiplex

You can submit application through [Simplex official website](https://www.simplex.com/partners). Simplex will get in touch with you and arrange an BD colleague with you, include but not limited: corporation introduction, background due diligence, demand communication.

### Step 2: Complete KYC, confirm opened trade pairs

Before creating account, Simplex need to KYC for you, include:

* **Corporate:** mainly use for follow-up contract signature and also you need to tell stakeholders’ names whose shares more than 25%.
* **Corporation Website:** Official website
* **Function presentation:** from user register to complete all trade, it can be recording or meeting presentation.
* **Users’ feedback:** the feedback for this exchange in third-party website.

Above documents are created by previous experiences. Detailed refer to requirement from Simplex.

<mark style="color:red;">You need to confirm with Simplex about the trade pairs need to open in advance.</mark>&#x20;

### Step 3: Get account for testing and submit application document

After Simplex complete the verification of your KYC, it will send to you three documents:

* **Integration Checklist:** need to fill in relevant information, submit Logo(250x150,PNG) show in website. **You can get account of testing environment here.**&#x20;
* **Wallet address:** If you want to get part of transaction fee from users in exchange, transaction fee will be transferred to wallet address you fill in regularly.(you can choose BTC/USDT, or get transaction fee according to type of coins)
* **Safety question:** some command questions, need to reply to Simplex

You need to submit above documents to Simplex and then get finally reality account.

#### Integration Checklist

Partner name in Simplex’s DB and Sandbox API Key are Simplex\_id and API\_key in exchange backend correspondingly, it need fill in backend of exchange. Others should be fill and reply to Simplex. Detailed description and sample are shown below:

| Item                                                                                                                                    | Description                                                                                                                                                                                  | Sample                                                      |
| --------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| IP/s to whitelist in Production (1-3 IPs are available per partner)                                                                     | Provide IP address of three server(states job, exhcnage Web API, exchange APP API) for Simplex. This address will add in white list. Only address in white list can require simplex service. | <p>100.0.0.1/24</p><p>200.0.0.1/24</p>                      |
| Subdomain URL – please specify the full domain name\s on which you will run the checkout page (in case the “widget” solution is chosen) | Open sub-domain url of payment page                                                                                                                                                          | Official domain/en\_US/creditCardPurchase                   |
| Referring domain – please indicate the domain on which the end-users will be referred from                                              | Exchange official website                                                                                                                                                                    | [www.chainapex.pro/en\_US](https://www.chainapex.pro/en_US) |
| Email address of the POC who receive the encrypted production API\_KEY.                                                                 | Be used for receiving email address of reality environment APIKey                                                                                                                            | <contact@chainup.com>                                       |
| Email address of the POC who will perform payments tests in PRODUCITON.                                                                 | Email address of production environment for testing                                                                                                                                          | <contact@chainup.com>                                       |
| Partner’s Fee in percentage                                                                                                             | Transaction fee from exchange, can be positive or negative(subsidies for users)                                                                                                              | 0%                                                          |
| Partner name in Simplex’s DB                                                                                                            | <mark style="color:red;">Exchange name</mark>                                                                                                                                                | chainup                                                     |
| Sandbox API Key                                                                                                                         | <mark style="color:red;">API Key in testing environment</mark>                                                                                                                               |                                                             |
| Implementing Simplex service on Web/iOS/Android                                                                                         | The place for applying Simplex service(Web/IOS/Android)                                                                                                                                      | Both of all                                                 |

After completing those things in integration checklist, mark done.

#### Wallet Address

Simplex can get certain fee from users when users buy coins through currency. If exchange also want to get certain fee from users, it can discuss with Simplex in advance. When transaction fee income of exchange is larger than 0%, Simplex can transfer transaction fee to address exchange provide.

**There are two ways of transaction fee payment:**

* Get single cryptocurrency: BTC OR USDT-ERC20.
* Get multiple cryptocurrency: the coins user buy, exchange can get transaction gee of corresponding coins.

If you don’t get transaction fee, you don’t need to submit this information.

#### Safety question

Below are regular response, copy directly and fill in Simplex document or website.

Q1: Simplex service will be available on: Android/iOS/Web

A1: Both of Android/iOS/Web.

Q2: Where is the wallet address generated?

A2: Automatically generated by the exchange system.

Q3: Where will you save the Simplex API key? client or server-side?

A3: Server-side

Q4: How will you secure Simplex API key?

A4: The API key will be stored in the configuration file, which only a few people have access to.

Q5: How will the crypto address injection work?

A5: According to the user id, crypto name, chain name, query the user's wallet address stored in the exchange database, and send it to simplex

Q6: Where is the wallet address/HD wallet/Deterministic wallet private key saved - on the client, the server, or both?

A6: The server

Q7: iOS/Android only - How is the server-side authenticating web requests coming from the client app? Is there some hard-coded API\_KEY in the app code itself that is used, or does the client app use 3rd party authentication (like SSO/OpenID/OAuth) and sends such an authentication token to the server side?

A7: https

Q8: How does the wallet authenticate the user when they wish to open the wallet - password? 2FA? Face/Fingerprint? SSO/OpenID/OAuth (if yes - what is the SSO/OpenID/OAuth provider?) Other?

A8: 2FA

### Step 4: Debug test environment

#### 1.  Configure account

Backend path: Trade management----currency trade(third-party)----Simplex configuration

<figure><img src="https://1775041679-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd1cEhboqiukWysySwLsO%2Fuploads%2FQuPEdNN9AJdyZbkaGhO4%2Fimage.png?alt=media&#x26;token=d320bb1b-50a3-4fe9-952f-20120bcb2cd5" alt=""><figcaption></figcaption></figure>

According to the information in Integration checklist in step 3, complete below configuration.

<figure><img src="https://1775041679-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd1cEhboqiukWysySwLsO%2Fuploads%2FQ5pG5mp6D0BcjX933tpK%2Fimage.png?alt=media&#x26;token=c313424d-e573-4bcd-afe7-972a5b31b7e4" alt=""><figcaption></figcaption></figure>

**Description:**

* **Status:** open/disable
  * **Open:** after opening, user can get the price of this channel when users buy coins and also users can trade through this channel.
  * **Disable:** after disabling, this channel cannot be used.
* **Type of account:** formal account and test account would get different API URL, please make sure the type of account and account are the same.
* **Simplex\_id:** the merchant’s name from Simplex, Partner name in Simplex’s DB in corresponding Integration Checklist.
* **API\_key:** You can find it through searching account of test environment in Integration Checklist.
* **Public\_key:** there are two different Public\_key for test environment and production environment. Colleague from Simplex will send separately.
* **Opened coins:** because Simplex has its own name of coins which is different from names in exchange. It need to maintain correspondence. For example, TUSDT in exchange, it would be called USDT-TRC20 in Simplex. It means user choose TUSDT in exchange, but in Simplex it is USDT-TRC20, Simplex will deposit USDT-TRC20 that deduct transaction fee to users’ wallet address.
  * **Coins in exchange:** show all ‘opened+open deposit’ coins, support fuzzy search, shown order according to coin order in backend, only show coins’ names, cannot be chosen for added coins to avoid one to many relationship.
  * **Simplex coins:** coins Simplex support(update daily), support fuzzy search, order from A to Z, show coins’ name and chain’s name, cannot choose added coins to avoid one-to-many relationship; can search supported coins of Simplex in <https://integrations.simplex.com/docs/supported\\_currencies#fiat-currencies>

#### 2.  Entrance for configuring Web

After completing parameter configuration of Simplex, you need to add function entrance, show below:

<figure><img src="https://1775041679-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd1cEhboqiukWysySwLsO%2Fuploads%2F2Aoxp3tDK7QnkEDJWy0M%2Fimage.png?alt=media&#x26;token=12068ef5-ec85-4bab-8acc-da52b3178975" alt=""><figcaption></figcaption></figure>

Backend path: Public Management- Web configuration-PC theme configuration-Page navigation-configuration, add ‘credit card’ in nagivation bar, show below:

<figure><img src="https://1775041679-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd1cEhboqiukWysySwLsO%2Fuploads%2F3zcNmt9WXPchBcaYDp2r%2Fimage.png?alt=media&#x26;token=585c6a71-ae0d-4c68-8cf2-7df29931ea05" alt=""><figcaption></figcaption></figure>

If there is no ‘third-party’ payment, you can click\[+] by yourself, detailed is shown below:

<figure><img src="https://1775041679-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd1cEhboqiukWysySwLsO%2Fuploads%2FnNsr5vqEqoX5cBYqpEgx%2Fimage.png?alt=media&#x26;token=97df1299-e3b8-434a-aace-88b327483477" alt=""><figcaption></figcaption></figure>

**Description:**

* Title: identify by yourself and it would be shown in web navigation.
* Title Type: choose ‘spot’.
* Access path: /creditCardPurchase

#### 3.  Entrance for configuring APP

Add \[Buy]module entrance in APP, show below:

&#x20;                                             ![](https://1775041679-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd1cEhboqiukWysySwLsO%2Fuploads%2F0rlQHIjaoVavFnuu2pSq%2Fimage.png?alt=media\&token=9946c954-4e10-4ba4-a7a4-c08a37957e13)

Backend path: Public Management-web configuration-Homepage, add ‘Buy crypto’ function, show below:

<figure><img src="https://1775041679-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd1cEhboqiukWysySwLsO%2Fuploads%2FPpuGrjnk0ZwIXwN6nCIz%2Fimage.png?alt=media&#x26;token=aa186a42-d97c-4a53-9e84-5840e7d342f8" alt=""><figcaption></figcaption></figure>

Click \[Add] bottom, Edit \[Staking]module information in detailed page, show below:

* Picture title: Buy crypto(name show in APP homepage).
* Access path: APP page-staking-buy crypto.
* Language: set up icon in certain language.
* Type: Android, IOS, H5. All of those need to configure separately.

This picture is shown the icon in Android APP, name show ‘Buy crypto’.

<figure><img src="https://1775041679-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd1cEhboqiukWysySwLsO%2Fuploads%2FDoLfjqBNUtuTmMK7w8ZN%2Fimage.png?alt=media&#x26;token=1eb26af6-cc94-4ac2-b83d-a6a998e1b0a9" alt=""><figcaption></figcaption></figure>

### Step 5: notify Simplex accept

After configuring relevant parameter, client need to test firstly and check if the process that buy crypto through credit card is smooth. If test is smooth, you can contact with Simplex to accept. Once Simplex accept successfully, they would give account of reality environment.&#x20;

**Credit card account provided by Simplex for testing:**

Credit card number: 4711 1000 0000 0000

Expire time: anytime in the future

Security code: 123

Picture: any

Detailed information can be checked:  <https://integrations.simplex.com/docs/testing-information>

###

### Step 6: get formal account, up-line

After passing acceptance of Simplex, API Key and other relevant information of reality environment would be sent to specific emailbox through LastPass. This email is provided in Integration Checklist.

You can use this email account to log in LastPass and then check corresponding API Key. Refer to step 4, replace account of reality environment to original test account. Public\_key will be sent by Simplex colleagues.

## FAQ

### Q1: What kind of fee need for opening Simplex?

A1: It need pay deposit.

### Q2: Which coins and currency are supported for Simplex?

A2：it can be searched via <https://integrations.simplex.com/docs/supported_currencies>. If coins cannot be found in this link, you can confirm with Simplex again. Coins that can be found the price through quot docker are fine.

In addition, You can check supported country and area via this link: <https://support.simplex.com/hc/en-gb/articles/360014137459-What-are-your-supported-locations-countries-states-and-territories->

### Q3: How does Simplex get transaction fee?

A3: Transaction fee can be divided into three parts:

* Commission for Simplex: 3.5% of trade amount or 10 dollars, get the higher one.
* Commission for liquidity provider: 1.45%-1.55% of trade amount generally.
* Transaction fee of merchant: income resource from users, also part of asset can be subsidies for users.

Example: user use 100 dollars to purchase USDT, the current exchange rate is 1.03, so:

Amount users can get=(100-10-100\*1.5%-0)/1.03=85.9USDT

### Q4: Are there transaction limitation?

A4: Limitation of transaction are:

* Single transaction: 50-20000 dollars
* Daily transaction: 20000 dollars(calculate from last purchase 24hours)
* Transaction monthly: 50000 dollars(calculate from last purchase 24hours)
