# CCPay 接入流程

[English Version](https://hackmd.io/msku8MQNQlG_ddPJQA2mxQ?view)

[中文版本](./)

### 接入流程
1. 前端接入 ccpay.js
2. 后端接入 CCPay 商户接口
3. 提供商户信息给 CCTip 平台，获得正式&测试环境的 appkey。
4. 提供应用信息
5. 在测试环境调试 ccpay.js 和 CCPay 商户接口
6. 提供正式环境的商户和应用信息，并进行调试
7. 上线发布

### CCPay.js
前端接入 [CCPay.js](https://github.com/BlockABC/ccpay.js)

### 后端 API
[《CCPay 商户接口文档-2.2》](https://hackmd.io/@blockabc/BJoGx_e1D)

### 商户信息
商户是应用在 CCTip 平台的账户，用于接收用户充值、沉淀用户资金等。
需要提供的信息如下，需要区分 正式 和 测试环境:

1. 商户名称，中英文；
2. 官网链接；
3. 域名白名单列表，精确到子域名。可配置多个，如：
    abc.com
    test.abc.com
    web.abc-test.io
4. 回调 url 地址。在用户充值给商户等操作时，CCPay 会通过该接口通知商户。

> 回调 url 格式及其其他说明信息请见文档 [《CCPay 商户接口文档》](https://hackmd.io/JyAWrFm9QBiKdFkIVYmR2A?view#10-%E5%85%85--%E6%8F%90%E5%9B%9E%E8%B0%83)
> 信息提供后，CCPay 会给到商户提供密钥等相关信息。

### 应用信息
* 应用网页入口链接
* Dapp 名称（英文）
* Dapp 一句话描述（英文）
* Dapp 详细描述（英文）
* Dapp 图标。
* 宽高比: 1:1; 建议尺寸: 200*200px
* Dapp 预览（移动端)。
* 宽高比: 9:16; 建议尺寸: 620*1102px，3张

### 测试用户
用于转入一些测试代币

### 安装客户端

**Android 测试环境**
~~http://abcwallet-gift.com/dq3y~~ 本链接失效
https://www.pgyer.com/tVIo

**Android 正式环境测试版**
https://oss-cctip.oss-cn-shenzhen.aliyuncs.com/CCTipBox-1.5.0.apk

**iOS**
http://abcwallet-gift.com/mn3b?release_id=5fe3fe5223389f15a4f47c83
需要先用这个链接获取本机 udid，并提供给 CCTip 开发人员。[获取 UDID](http://www.pgyer.com/tools/udid)

**iOS 环境切换**
可以通过点击首页左上角的 "Apps" 来切换正式和测试环境。

如需密码，请联系 CCTip 人员私下获取。
以上正式环境都只是数据的正式环境，并非线上版本。线上版本 UI 上会略有区别。

### Webview URL 参数调试
目前可以通过 [URL 参数](https://github.com/BlockABC/ccpay.js/blob/master/docs/Webview-Config.md) 来控制 Webview 的展示效果。
为了尝试不同的 URL 参数组合，我们提供了测试 URL 参数的入口，具体如下：

**iOS**
测试环境下长按首页左上角“APPS”，打开 URL 输入框，输入带有不同参数的应用 URL。

**Android**
测试环境首页顶部有 URl 输入框，可以输入不同页面&参数组合来测试。

### 测试代币获取
ETH 测试网ropsten水龙头: https://faucet.ropsten.be/
BTC 测试网test3水龙头: https://testnet-faucet.mempool.co/
BCH 测试网test3水龙头: https://developer.bitcoin.com/faucets/bch/?no-cache=1
BSV 测试网test3水龙头：https://faucet.bitcoincloud.net/
LTC 测试网水龙头： https://tltc.bitaps.com/

ETH 测试网浏览器: https://ropsten.etherscan.io/
BTC 测试网浏览器: https://live.blockcypher.com/btc-testnet/
BCH/SLP 测试网浏览器: https://explorer.bitcoin.com/tbch
BSV测试网浏览器： https://test.whatsonchain.com/
LTC测试网浏览器： https://tltc.bitaps.com/