# CCPay Integration Guide

[English Version]('./')

[中文版本](https://hackmd.io/Y_dnQ5P1TnmQR6xED5WyjA?view)

The required information is as follows, and may vary in official and test environments:

>Note: One merchant may correspond to multiple applications.

### Merchant Information

* Merchant name, in Chinese and English;
* Official website link;
* Multiple domain names can be configured in the whitelist, such as:

* [abc.com](http://abc.com/)
* [def.io](http://def.io/)

* Callback interface, where CCPay notifies the merchant when the user deposits tokens in the merchant, etc. For the url format and other instructions, please refer to the document [CCPay Merchant Interface Document-2.1](https://hackmd.io/@blockabc/BJoGx_e1D)

>After the information is provided, CCPay will provide the merchant with the key and other related information.

### Application Information

* Application webpage link;
* Application introduction in one sentence;
* Detailed description of the application, with up to 255 characters;
* Application logo images;
* The banner images of the application, consistent with the agreed banner specification;

### Test User

To transfer some test tokens

### CCPay.js

Access [CCPay.js](https://github.com/BlockABC/ccpay.js) in the front end

### Backend API

[CCPay Merchant Interface Document-2.1](https://hackmd.io/@blockabc/BJoGx_e1D)

### Banner Specification

### Install Client

**iOS**

[http://abcwallet-gift.com/mn3b](http://abcwallet-gift.com/mn3b)

Obtain the native udid from this link and provide it for CCTip developers. [Get UDID](http://www.pgyer.com/tools/udid)

**iOS Environment Switch**

You can switch between the official and test environments by clicking "Apps" in the upper left corner of the homepage.

**Android Test Environment**

[https://www.pgyer.com/tVIo](https://www.pgyer.com/tVIo)

**Android Official Environment**

[https://www.pgyer.com/f9pP](https://www.pgyer.com/f9pP)

### The password is obtained privately.

### Webview URL Parameter Debugging

The display effect of Webview can be controlled with [URL parameters](https://github.com/BlockABC/ccpay.js/blob/master/docs/Webview-Config.md).

To try different URL parameter combinations, we provide an entrance to test URL parameters, as follows:

**iOS**

In the test environment, long press "APPS" in the upper left corner of the homepage to open the URL input box and enter the application URL with different parameters.

**Android**

There is a URL input box at the top of the test environment homepage, you can enter different pages & parameter combinations to test.

### Get Test Tokens

ETH testnet ropsten faucet:[https://faucet.ropsten.be/](https://faucet.ropsten.be/)

BTC testnet test3 faucet:[https://testnet-faucet.mempool.co/](https://testnet-faucet.mempool.co/)

BCH testnet test3 faucet:[https://developer.bitcoin.com/faucets/bch/?no-cache=1](https://developer.bitcoin.com/faucets/bch/?no-cache=1)

BSV testnet test3 faucet:[https://faucet.bitcoincloud.net/](https://faucet.bitcoincloud.net/)

LTC testnet faucet:[https://tltc.bitaps.com/](https://tltc.bitaps.com/)

ETH testnet explorer:[https://ropsten.etherscan.io/](https://ropsten.etherscan.io/)

BTC testnet explorer:[https://live.blockcypher.com/btc-testnet/](https://live.blockcypher.com/btc-testnet/)

BCH/SLP testnet explorer:[https://explorer.bitcoin.com/tbch](https://explorer.bitcoin.com/tbch)

BSV testnet explorer:[https://test.whatsonchain.com/](https://test.whatsonchain.com/)

LTC testnet explorer:[https://tltc.bitaps.com/](https://tltc.bitaps.com/)