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.

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:

statusDescription
1Successful deposit
2Failed 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

NameTypeDescription
pidinteger(int64)Project ID
cidinteger(int64)Cregis ID
chain_idstringChain ID
token_idstringToken ID
currencystringCurrency Label
addressstringAddress
amountstringAmount
statusinteger(int32)Status
txidstringTransaction hash
block_heightstringBlock Height
block_timeinteger(int64)Block Time
memostringmemo or tag on blockchain,Only support Ton and Xrp
noncestring6-character random string
timestampinteger(int64)Timestamp
signstringSignature
Example
{
    "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"
}