> For the complete documentation index, see [llms.txt](https://docs.ccpayment.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ccpayment.com/ccpayment-v1.0-api/wallet-api-ccpayment/get-permanent-deposit-address-for-users.md).

# Get permanent deposit address for users

Each [App ID of the merchant](https://admin.ccpayment.com/developer/config) can obtain 1000 addresses via the interface. If you want more addresses available, please [contact customer service](https://t.me/CCPaymentSupportBot) for depth help.

## Get addresses that will not expire for users to deposit directly;

<mark style="color:green;">`POST`</mark> `https://admin.ccpayment.com/ccpayment/v1/payment/address/get`

#### Headers

| Name                                           | Type   | Description                                                                                                                                                         |
| ---------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Sign<mark style="color:red;">\*</mark>         | string | SHA-256 (APPID + APP Secret +timestamp+<mark style="color:red;">**body (json string)**</mark>). [Signature guide](/ccpayment-v1.0-api/to-get-started/signature.md). |
| Timestamp<mark style="color:red;">\*</mark>    | string | Timestamp in seconds (10-digit). The request is valid for two minutes.                                                                                              |
| Appid<mark style="color:red;">\*</mark>        | string | Merchant's unique credential. Find it on the [Developer page](https://admin.ccpayment.com/developer/config)                                                         |
| Content-Type<mark style="color:red;">\*</mark> | String | application/json; charset=utf-8                                                                                                                                     |

#### Request Body

| Name                                       | Type   | Description                                                                                                                                                                                        |
| ------------------------------------------ | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| user\_id<mark style="color:red;">\*</mark> | string | <p>User ID, unique identification<br>3-64characters</p>                                                                                                                                            |
| chain<mark style="color:red;">\*</mark>    | string | <p>Blockchain network, unique identification</p><p><a href="https://docs.google.com/spreadsheets/d/1YKY-pxCdqer1IurgEkyNqW0xIj7EmtfX3rILoJqkKgw/edit#gid=0">Click here to check chain list</a></p> |
| notify\_url                                | string | The URL address will be notified via a POST request when the order status changes. Ensure the URL is accessible to receive notifications from the payment platform.                                |

{% tabs %}
{% tab title="200: OK Success (200)/Fail (200)" %}
{% tabs %}
{% tab title="Success (200)" %}

#### **Response (Success 200)**

**Header**

**Body**

```json
{
	"code": 10000,
	"msg": "success",
	"data": {
		"address": "TYWnk1EGALQyYst2yFSd29QQQTEkuKMbyt",
		"memo": "",
	}
}
```

**Parameters**
{% endtab %}

{% tab title="Fail (200)" %}

#### **Response (Fail 200)**

```json
{
	"code": 224066,
	"msg": "Service error, pleaser try again",
	"data": null
}
```

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

<table><thead><tr><th>Name</th><th>Value</th><th width="108" data-type="checkbox">Required</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>code</td><td>224066</td><td>true</td><td>Number</td><td></td></tr><tr><td>msg</td><td>Service error, please try again</td><td>true</td><td>String</td><td></td></tr><tr><td>data</td><td></td><td>true</td><td>Object</td><td></td></tr></tbody></table>

<table><thead><tr><th width="193">Name</th><th width="173">Value</th><th data-type="checkbox">Required </th><th>Type</th><th width="153">Description</th></tr></thead><tbody><tr><td>address</td><td>TYWnk1EGALQyYst2yFSd29QQQTEkuKMbyt</td><td>true</td><td>String</td><td>The corresponds to the chain address of the network</td></tr><tr><td>memo</td><td>12345</td><td>true</td><td>String</td><td>Tag data of Memo coins, used to label and identify user addresses</td></tr></tbody></table>

<table><thead><tr><th width="134">Name</th><th width="188">Value</th><th width="118">Required</th><th width="82">Type</th><th width="299">Description</th></tr></thead><tbody><tr><td>Appid</td><td>202302010636261620672405236006912</td><td>Y</td><td>String</td><td>Merchant's unique credential. Find it on the <a href="https://admin.ccpayment.com/developer/config">Developer page</a></td></tr><tr><td>Timestamp</td><td>1677152490</td><td>Y</td><td>String</td><td>Timestamp in seconds (10-digit). The request is valid for two minutes.</td></tr><tr><td>Sign</td><td>871f0223c66ea72435208d03603a0cb00b90f6ac4a4ba725d00164d967e291f6</td><td>Y</td><td>String</td><td>SHA-256(appId + appSecret + timestamp+<mark style="color:red;"><strong>body(json string)</strong></mark>)</td></tr></tbody></table>

#### Note: Each user only has one deposit address with each chain.

* **The deposit introduction:**

The system will scan the transaction on the blockchain when it receives the notice of deposit and credit the assets to the merchant’s account after checking success. And will send the deposit success notification to the webhook URL specified by the merchant.

{% hint style="danger" %}
The address obtained from the interface only receives [the token listed on CCPayment](https://bit.ly/CCsupportedcoins). Check the token list for details. Please do not deposit unlisted tokens to CCPayment to avoid asset loss.
{% endhint %}

### Webhook notification

CCPayment will notify merchants the final transaction results. [Go to Webhook Configuration Guide](/ccpayment-v1.0-api/webhook-notification/webhook-notification-tutorial.md).

> Once the merchant has processed the order, please return {http code: 200} and include a “success” string in the HTTP response body. <br>
>
> If CCPayment does not receive “success” as a response from the merchant, CCPayment will keep pushing the notification up to 6 times. Any response other than “success” will be regarded as a failure, and CCPayment will keep sending the notification.

**Example**

{% tabs %}
{% tab title="PHP" %}

```php
$this->response->setString("success")
```

{% endtab %}

{% tab title="Java" %}

```java
this.response.setString("success");
```

{% endtab %}

{% tab title="Golong" %}

```go
this.response.SetString("success")
```

{% endtab %}

{% tab title="Python" %}

```python
self.response.set_string("success")
```

{% endtab %}

{% tab title="Node.js" %}

```javascript
this.response.setString("success");
```

{% endtab %}
{% endtabs %}

<figure><img src="/files/cGmzYqFhG3WWqP8yXg6S" alt=""><figcaption><p>Response Example</p></figcaption></figure>

{% content-ref url="/pages/mHETFcxDKDj61suWofF4" %}
[Withdraw Webhook Notification](/ccpayment-v1.0-api/webhook-notification/withdraw-webhook-notification.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ccpayment.com/ccpayment-v1.0-api/wallet-api-ccpayment/get-permanent-deposit-address-for-users.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.