Simplex配置说明
Last updated
Last updated
Simplex 是一家获得欧盟许可的金融机构和 1 级服务商，为加密行业提供完整的法币基础设施。 2021 年 9 月，全球领先的支付技术提供商 Nuvei 收购了 Simplex，为合作伙伴提供了更强大的金融科技解决方案，让所有人更容易获得加密货币。
目前币安、火币、Okex、Kucoin、Gateio、Bybit、Trust、Trezor等多家知名交易所、钱包都在使用Simplex作为他们的法币入金解决方案。
您可以通过提交申请，Simplex将会指定商务人员与您取得联系，包括但不限于：企业介绍，背景调查，需求沟通，开设账号。
开设帐号前，Simplex需要对您进行基础的KYC，包括：
企业法人：主要用于后续的合同签名，可能需要告知占股超过25%的股东姓名；
企业网站：官网链接；
功能演示：从用户注册到完成全部交易，可以是录屏或者会议演示；
用户评价：用户在第三方网站对交易所的评价；
以上资料是基于过往开通经验整理形成，具体以Simplex要求为准。
您需要提前跟Simplex约定好需要开通哪些交易对。
当Simplex完成了对您的KYC审核后，将会给您发送三份资料：
检查清单（Integration Checklist）：需要填写相关信息，提交用于网页展示的Logo（250 x150，PNG格式），这里面会有测试环境账号；
钱包地址：如果您想要对交易所用户收取部分手续费，Simplex需要您提供接收手续费的地址。
安全问题：一些常见问题，Simplex安全团队会进行审查；
您需要提交上述资料给Simplex后，才能获取最终的真实账号，在此之前您都可以使用测试账号进行系统调试。
其中Partner name in Simplex’s DB和Sandbox API Key分别对应交易所后台的Simplex_id和API_key，需要填写到交易所后台，其他都是需要填写后回复给simplex的，具体说明和示例如下表：
IP/s to whitelist in Production (1-3 IPs are available per partner)
需要将states job、exchange Web API、exchange APP API三个的服务器的IP地址给到simplex，这个地址会加入白名单，只有白名单地址可以请求simplex服务
100.0.0.1/24
200.0.0.1/24
Subdomain URL – please specify the full domain name\s on which you will run the checkout page (in case the “widget” solution is chosen)
打开支付页面的子域名url
官网域名/en_US/creditCardPurchase
Referring domain – please indicate the domain on which the end-users will be referred from
交易所官网
Email address of the POC who receive the encrypted production API_KEY.
用于接受真实环境APIKey的邮箱地址
contact@chainup.com
Email address of the POC who will perform payments tests in PRODUCITON.
生产环境进行测试的邮箱地址
contact@chainup.com
Partner’s Fee in percentage
交易所准备收取多少手续费，可以为正数，也可以为负数（补贴用户的）
0%
Partner name in Simplex’s DB
交易所名称
chainup
Sandbox API Key
测试环境API Key
Implementing Simplex service on Web/iOS/Android
将simplex服务应用在哪里（Web/iOS/Android）
Both of all
文档后面的检查清单（Integration checklist）确认完成后，全部标注为done即可。
Simplex本身要对用户的法币入金收取一定的费用，在此基础上，如果交易所也想向用户收取部分费用，可以提前跟Simplex约定好。当交易所的手续费收入大于0%时，Simplex将定期向交易所提供的地址转入手续费；
手续费支付方式有两种：
以单一加密货币收取费用：统一折算成BTC 或 USDT-ERC20；
以多种加密货币收取费用：用户买入什么币种，交易所收取对应币种作为手续费；
如果不收取手续费，则不需要提交此信息。
以下为通用答复，直接复制答案填写到Simplex文档或者网页上即可。
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
后台路径：交易管理 - 法币交易（第三方）- 第三方管理 - Simplex配置，如下图所示；
根据第三步中Integration Checklist文档中的信息，完成下面的配置：
字段说明：
排序：显示在用户端的顺序，可填入1-100的整数，初始值为1，必填；在用户端正序显示对应的第三方，当数字相同时，按照第三方名字字母a-z的顺序显示；
状态：启用/禁用
启用：开启后，用户进行快捷买币的时候，会展示该服务商的报价，可通过该服务商进行交易；
禁用：禁用后，该服务商不可用；
账号类型：正式账号 与 测试账号 会对应不同的API URL，请确保账号类型与下面的账号一致；
Simplex_id：Simplex给您开通的商户名称，对应Integration Checklist文档里Partner name in Simplex’s DB；
API_key：可在Integration Checklist文档里查找测试环境（Sandbox）账号；
Public_key：测试环境和生产环境是不同的Public_key，Simplex的工作人员会单独发；
开通的币种：由于Simplex会自己维护一套币种名称，跟交易所的币种名称可能不同，因此需要维护一个对应关系，比如交易所叫TUSDT，Simplex可能叫做USDT-TRC20，通过维护这样一个对应关系，表示用户在交易所选择法币入金TUSDT，实际上是要入金Simplex的USDT-TRC20币种，Simplex将扣除手续费后的USDT-TRC20充入用户的交易所钱包地址即可；
交易所币种：展示所有“已开启+开启充值”的币种，支持模糊搜索，按后台的币种顺序展示，仅显示币种名称，已添加（选择）的币种不可再选，避免出现一对多的关系；
Simplex币种：Simplex支持的币种（每天1点30分更新一次），支持模糊搜索，按A→Z排序，显示币种名称+链名称，已添加（选择）的币种不可再选，避免出现一对多的关系；
完成Simplex的参数配置后，需要添加功能入口，如下图所示：
后台路径为：公共管理 - 网站配置 - PC主题配置 - 首页模板 - 首页导航 - 配置，添加“信用卡买币”到导航栏，如下图所示：
如果没有“信用卡买币”选项，可点击【+】自行添加，具体如下图所示：
字段说明：
导航icon：Web端导航菜单的图片，支持白天版和夜间版分别配置，未配置夜间版icon则展示白天版；
标题/副标题：自定义内容，会展示在Web导航处；
标题类型：要选择“现货”类型；
访问路径：/creditCardPurchase；
角标：默认关闭，可以选择ChainUp提供的两种样式，也可以上传自定义的图标；
在App版首页增加【快捷买币】模块入口，如下图所示：
后台路径为：公共管理 - APP管理 - APP主题配置-功能区，点击“添加”按钮，如下图所示：
点击【添加】按钮，在详情页编辑 【买币】 模块信息，如下图所示：
展示端：安卓、ios需要分开设置；
图片标题：买币（APP首页显示名称）；
语言：设置APP在哪种语境下展示该icon；
访问路径：APP原生页面-增值服务-快捷买币；
排序：功能展示的顺序；
icon：支持白天版和夜间版分别配置，未配置夜间版icon则展示白天版；
下图表示在安卓app中文下展示此icon，显示名称为“买币”
配置好相关参数后，商户需要先自行进行测试，看整个信用卡买币流程是否通畅，如果测试没有问题，可以联系Simplex进行验收。只有Simplex验收通过后，才会交付真实环境的账号。
Simplex提供了用于测试的信用卡账号：
信用卡号: 4711 1000 0000 0000
有效期: 未来的任何时间
背面安全码: 123
图片：任意
Simplex验收通过后，将通过LastPass发送真实环境的API Key等信息到交易所的指定邮箱，此邮箱是第三步在检查清单（Integration Checklist）中填写的邮箱号。
使用此邮箱账号登录LastPass即可查询对应的API Key，参考第四步，将真实环境的账号替换原来的测试账号即可。Public_key由Simplex人员单独发送。
A1：需要缴纳保证金
A3：Simplex的收费分成3部分：
Simplex自己的佣金，交易金额的3.5%或者10美金，哪个高取哪个；
流动性提供者的佣金，通常是交易金额的1.45%~1.55%；
商户的手续费：可以向用户收取作为收入来源，也可以拿出部分自有资金补贴用户；
举例：用户使用100美金购买USDT，此时汇率是1.03，则：
用户可得 = （100-10-100*1.5%-0）/ 1.03 = 85.9 USDT
A4：交易限额如下：
单笔限额：50~20000美元
单日限额：20000美元（非自然日，从上次购买后的 24 小时计算）
单月限额：50000美元（非自然月，从上次购买后的 31天计算）
具体信息可参考：
A2：可以通过（）查看，如果上面没有需要的币种，可以跟Simplex进一步确认，只要能够通过 quot 接口查询到价格就行。
另外，可以通过下面的链接查看支持哪些国家和地区
