Token ID Interface

Call this interface to get the Token ID for your supported tokens. Token ID is the parameter that you should pass to CCPayment's server when you create payment and withdrawal orders with CCPayment.

CCPayment provides merchants with 100+ tokens on various blockchains.

To simplify the management of token assets with the same symbol for both merchants and their customers, CCPayment consolidates balances of tokens with identical symbols.

For instance, when users receive USDT on the ETH chain, they can withdraw USDT from any supported chain.

You can view the complete list of supported tokens through the form below. https://bit.ly/CCsupportedcoins

Get Token ID

Return supported Token ID configuration of “tokens for your business” in the merchant’s backend

POST https://admin.ccpayment.com/ccpayment/v1/coin/all

Return all Token IDs of selected tokens enabled by you. Return all Token IDs supported by CCPayment if you enabled All Tokens in your Merchant Settings.

Headers

Name	Type	Description
Appid*	String	Merchant's unique credential. Find it on the Developer page.
Timestamp*	String	Timestamp in seconds (10-digit). The request is valid for two minutes.
Sign*	String	SHA-256 (APPID + APP Secret +timestamp+body (json string)). Signature guide.
Content-Type*	String	application/json; charset=utf-8

200: OK Success (200)/ Fail (200)

Header

Name	Value	Required	Type	Description
Appid	202302010636261620672405236006912	Y	String	Merchant's unique credential
Timestamp	1677152490	Y	String	Timestamp in seconds (10-digit). The request is valid for two minutes.
Sign	871f0223c66ea72435208d03603a0cb00b90f6ac4a4ba725d00164d967e291f6	Y	String	SHA-256(APPID + APPSecret + timestamp+body(json string))

Body

{
    "code": 10000,
    "msg": "success",
    "data": {
        "list": [
            {
                "symbol": "BTC",
                "crypto": "BTC",
                "name": "Bitcoin",
                "logo": "https://resource.cwallet.com/token/icon/btc.png",
                "min": "0.00008",
                "price": "29196.27",
                "precision":8,
                "coin_id": "f36ad1cf-222a-4933-9ad0-86df8069f916",
                "status": 1,
                "tokens": [
                    {
                        "token_id": "f36ad1cf-222a-4933-9ad0-86df8069f916",
                        "crypto": "BTC",
                        "logo": "https://resource.cwallet.com/token/icon/btc.png",
                        "name": "Bitcoin",
                        "is_support_memo": false,
                        "network": "Bitcoin",
                        "chain": "BTC",
                        "network_coin_id":"f36ad1cf-222a-4933-9ad0-86df8069f916",
                        "network_fee_crypto":"BTC",
                        "contract": "BTC",
                        "precision":8,
                        "chain_logo": "https://resource.cwallet.com/token/icon/btc.png",
                        "status": 1
                    }
                ]
            },
           
            {
                "symbol": "ETH",
                "crypto": "ETH",
                "name": "Ethereum",
                "logo": "https://resource.cwallet.com/token/icon/ETH.png",
                "min": "0",
                "price": "1902.84",
                "precision":18,
                "coin_id": "e8f64d3d-df5b-411d-897f-c6d8d30206b7",
                "status": 1,
                "tokens": [
                    {
                        "token_id": "1e614496-f9ce-4ec7-8e68-563733deacbf",
                        "crypto": "ETH",
                        "logo": "https://resource.cwallet.com/token/icon/ETH.png",
                        "name": "Binance Smart Chain",
                        "is_support_memo": false,
                        "network": "BEP20",
                        "chain": "BSC",
                        "network_coin_id":"e8f64d3d-df5b-411d-897f-c6d8d30206b7",
                        "network_fee_crypto":"ETH",
                        "contract": "0x2170ed0880ac9a755fd29b2688956bd959f933f8",
                        "precision":18,
                        "chain_logo": "https://resource.cwallet.com/token/icon/wbnb.png",
                        "status": 1
                    },
                    {
                        "token_id": "8addd19b-37df-4faf-bd74-e61e214b008a",
                        "crypto": "ETH",
                        "logo": "https://resource.cwallet.com/token/icon/ETH.png",
                        "name": "Ethereum",
                        "is_support_memo": false,
                        "network": "ERC20",
                        "network_coin_id":"e8f64d3d-df5b-411d-897f-c6d8d30206b7",
                        "network_fee_crypto":"ETH",
                        "chain": "ETH",
                        "contract": "1",
                        "precision":18,
                        "chain_logo": "https://resource.cwallet.com/token/icon/eth.png",
                        "status": 1
                    },
                    {
                        "token_id": "f36770ed-d8fd-4a21-8141-83478fa44e05",
                        "crypto": "ETH",
                        "logo": "https://resource.cwallet.com/token/icon/ETH.png",
                        "name": "Optimism",
                        "is_support_memo": false,
                        "network": "OPTIMISM",
                        "network_coin_id":"e8f64d3d-df5b-411d-897f-c6d8d30206b7",
                        "network_fee_crypto":"ETH",
                        "chain": "OPTIMISM",
                        "contract": "10",
                        "precision":18,
                        "chain_logo": "https://resource.cwallet.com/token/op.png",
                        "status": 1
                    }
                ]
            }
        ]
    }
}

Parameters

Name	Type	Required	Description
code	Integer
msg	String
data	Object
data.list	Array		Crypto coin list
data.list.coin_id	String		Identification of the crypto coin ''coin_id can be used to identify which coin is transferring to Cwallet account''
data.list.symbol
data.list.crypto	String		Coin symbol
data.list.name	String		Coin fullname
data.list.precision	Integer		Precision of the coin
data.list.logo	String		Coin icon
data.list.min	String		Minimum trading amount
data.list.price	String		Current price (in USD)
data.list.status	Int		Status: 1, token can be used for payment, deposit and withdrawal. Status: 2, token is under maintenance, the service of transfer and payment is suspended temporarily. Status: 3, token is to be delisted, token cannot be used for transfer and payment, merchant can only withdraw it.
data.list.tokens	Array		The list of tokens on different networks
data.list.tokens.token_id	String		Tell CCPayment's server the information of the coin and its transaction network
data.list.tokens.crypto	String		Symbol of token, example: "ETH"
data.list.tokens.logo	String		Token icon
data.list.tokens.name	String		Full name of the chain, Example: "Optimism"
data.list.tokens.is_support_memo	Boolean		If the parameter value is true, it means that the token supports filling in memo or Tag
data.list.tokens.network	String		Token Protocol, Example: "ERC20"
data.list.tokens.network_coin_id	String		Coin ID for network fee crypto.
data.list.tokens.network_fee_crypto	String		Crypto unit of network fee.
data.list.tokens.chain	String		Abbreviation of the chain name, Example: "OP"
data.list.tokens.contract	String		The identification of the token on the corresponding blockchain network
data.list.tokens.precision	Integr		Precision of the token
data.list.tokens.chain_logo	String		Icon of network
data.list.tokens.status	Int		Status: 1, token can be used for payment, deposit and withdrawal. Status: 2, token is under maintenance, the service of transfer and payment is suspended temporarily. Status: 3, token is to be delisted, token cannot be used for transfer and payment, merchant can only withdrawn it.

Remark

Remark 1

As a security measure, we will sign the returned data (and according to this only { code: 10000 } should be signed, but it's signing all the returned body.). Additionally, it will return Appid, Sign, Timestamp in the header of the response. The signature method SHA-256 (appid+appSecret+Timestamp+body).

Please use the data with caution if the signature verification fails. It indicates that the data has been tampered with.

Remark 2

Usually, users must select a coin and network to allow the merchant's application to determine the token_id for the checkout.

Fail (200)

{
    "code": 224066,
    "msg": "service err, please try again"
}

If you have any questions or concerns about managing integrated tokens, our customer managers are ready to assist you with any issues during the integration process.