机器翻译

本页面使用机器翻译。如有任何不一致之处，请参阅英文文档。

回调

Crypto2B 可以为客户系统生成有关操作的通知（例如充值、提现、服务操作、地址检查）。这一机制就是通过回调实现的。

设置

如果客户希望使用回调机制来跟踪操作的处理状态，需要在个人账户中配置回调 URL。

之后，在处理加密货币支付时，Crypto2B 会以 JSON 格式向该 URL 发送包含交易所有必要信息的通知。

回调内容

Crypto2B 的回调包含有关交易的所有重要信息：

• 操作类型
• 处理状态
• 币种
• 地址
• 金额
• 区块链中的交易哈希
• 确认数
• 手续费

等等

回调示例

充值

{
  "data": {
    "type": "Deposit",
    "id": 123456,
    "status": "Success",
    "date": "2024-01-15T10:30:00Z",
    "clientDepositId": "client-deposit-001",
    "error": null,
    "instrument": {
      "currencyShortName": "USDT",
      "transportProtocol": "trc20"
    },
    "address": {
      "address": "TExampleDepositAddress1234567890abc",
      "tag": null,
      "foreignId": "user-12345",
      "senderAddress": "TExampleSenderAddress0987654321xyz"
    },
    "transaction": {
      "approach": "FullProcessing",
      "hash": "abc123def456abc123def456abc123def456abc123def456abc123def456abcd",
      "amount": 1000.50,
      "confirmations": 21,
      "amlRiskGrade": "Low"
    },
    "fees": [
      {
        "type": "Commercial",
        "currencyShortName": "USDT",
        "transportProtocol": "trc20",
        "amount": 5.00
      }
    ]
  }
}

提现

{
  "data": {
    "type": "Withdrawal",
    "id": 789012,
    "status": "Success",
    "date": "2024-01-15T14:45:00Z",
    "paymentOrderId": "withdrawal-order-001",
    "foreignId": "user-withdrawal-789",
    "error": null,
    "instrument": {
      "currencyShortName": "BTC",
      "transportProtocol": "btc"
    },
    "address": {
      "address": "bc1qexamplewithdrawaladdress000000000000000",
      "tag": null
    },
    "transaction": {
      "approach": "FullProcessing",
      "hash": "00000000000000000000abcdef1234567890abcdef1234567890abcdef123456",
      "amount": 0.05,
      "confirmations": 6,
      "amlRiskGrade": null
    },
    "fees": [
      {
        "type": "Commercial",
        "currencyShortName": "BTC",
        "transportProtocol": "btc",
        "amount": 0.0001
      },
      {
        "type": "Technical",
        "currencyShortName": "BTC",
        "transportProtocol": "btc",
        "amount": 0.00005
      }
    ]
  }
}

服务操作

{
  "data": {
    "type": "Service",
    "id": 345678,
    "soType": "Common",
    "status": "Success",
    "date": "2024-01-15T16:00:00Z",
    "error": null,
    "instrument": {
      "currencyShortName": "ETH",
      "transportProtocol": "erc20"
    },
    "sender": "0x0000000000000000000000000000000000000001",
    "recipient": "0x0000000000000000000000000000000000000002",
    "transaction": {
      "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "amount": 2.5,
      "confirmations": 35
    },
    "technicalFee": {
      "currencyShortName": "ETH",
      "transportProtocol": "erc20",
      "amount": 0.002
    }
  }
}

地址检查

{
  "data": {
    "type": "AddressCheck",
    "checkId": "550e8400-e29b-41d4-a716-446655440000",
    "address": "TJYeasypBnB2x5hLTpYPQZ6YR9ZL3hLj6b",
    "status": "Completed",
    "amlRiskGrade": "Low",
    "description": "Exchange wallet",
    "currency": "USDT",
    "protocol": "Tron",
    "feeAmount": 0.5,
    "feeCurrencyShortName": "USDT",
    "timestamp": "2024-01-15T10:30:00Z",
    "errorCode": null,
    "errorMessage": null
  }
}

字段说明

字段	说明
type	操作类型：Deposit、Withdrawal、Service、AddressCheck
id	系统中操作的唯一标识符
status	操作处理状态
date	操作日期和时间（ISO 8601）
instrument	有关币种和协议的信息
address	交易地址及附加参数
transaction	区块链交易详情
fees	手续费数组（商业费用、技术费用）
error	错误信息（如有）

充值专有字段

字段	说明
clientDepositId	客户系统中的充值 ID
address.foreignId	外部用户标识符
address.senderAddress	发送方地址

提现专有字段

字段	说明
paymentOrderId	支付订单 ID
foreignId	外部操作标识符

服务操作专有字段

字段	说明
soType	服务操作类型（例如 Common）
sender	发送方地址
recipient	接收方地址
technicalFee	该操作的技术费用

地址检查回调字段

地址检查回调不包含通用的 id、date、instrument、address、transaction 和 fees 字段。其结构在地址检查一节中有详细说明。

重要提示

去重

请注意，由于实现细节的原因，同一个回调有时可能会被发送不止一次。请务必通过跟踪交易标识符来避免重复扣款等类似问题。