机器翻译

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

回调

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": "Collection",
    "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
    }
  }
}

字段说明

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

充值特定字段

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

提现特定字段

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

服务操作特定字段

字段	说明
soType	服务操作类型(例如,Collection)
sender	发送方地址
recipient	接收方地址
technicalFee	操作的技术手续费

重要提示

去重

请注意,由于实现细节,同一回调有时可能会被发送多次。请始终跟踪交易标识符,以避免重复支付和类似问题。