> ## Documentation Index
> Fetch the complete documentation index at: https://developer.cregis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Address deposit notify

> The callback notification for address deposit result.

## Callback API

*The callback URL is provided in request body by the request initiator. For more details, see the `callback_url` parameter in the [Create Address API](/api-reference/request-apis/address/address-generate).*

This API allows `cregis` to initiate callback request to the original API caller.

The callback comes in two scenarios, which are determined by the `status` in the callback content. These scenarios are mutually exclusive and only trigger once:

| status | Description        |
| ------ | ------------------ |
| 1      | Successful deposit |
| 2      | Failed deposit     |

After initiating the callback, when the returned content is `success`, the callback is successful. Otherwise, the callback fails. If the callback fails, you can push it again, you can log into the `cregis` client, select the corresponding project in the menu, and re-push it from the callback record.

> Note: Different types of callbacks will have different content. It is strongly recommended to use different APIs for different types of callbacks to ensure clear and specific business logic.

#### Request Method

HTTP POST   application/json

#### Request Parameters

| Name          | Type           | Description                                        |
| ------------- | -------------- | -------------------------------------------------- |
| pid           | integer(int64) | Project ID                                         |
| cid           | integer(int64) | Cregis ID                                          |
| chain\_id     | string         | Chain ID                                           |
| token\_id     | string         | Token ID                                           |
| currency      | string         | Currency Label                                     |
| address       | string         | Address                                            |
| amount        | string         | Amount                                             |
| status        | string         | Status                                             |
| txid          | string         | Transaction hash                                   |
| block\_height | string         | Block Height                                       |
| block\_time   | string         | Block Time                                         |
| memo          | string         | memo or tag on blockchain，Only support Ton and Xrp |
| nonce         | string         | 6-character random string                          |
| timestamp     | integer(int64) | Timestamp                                          |
| sign          | string         | Signature                                          |

###### Example

```json theme={null}
{
    "pid": 1382528827416576,
    "cid": 1391751691788288,
    "chain_id":"195",
    "token_id":"195",
    "currency": "TRX",
    "amount": "1.2",
    "address":"TXsmKpEuW7qWnXzJLGP9eDLvWPR2GRn1FS",
    "status": "1",
    "txid": "6dd05b0972075542219a3fcc116c58feaf9480f1f698cc46c4367ded83955cfd",
    "block_height": "34527604",
    "block_time": "1686814482000",
    "nonce": "ubqso3",
    "timestamp": 1687850657960,
    "sign": "f5be13fdd8c6f63951ca4427359457cb"
}
```