Bitcoin Call Back

The Bitcoin Callback feature is designed to handle transaction confirmations and address timeouts. The system checks the transaction status at multiple intervals and notifies the callback URL accordingly.

Callback Time Intervals

1. 15 mins: Initial check for transaction.

2. 30 mins: Second check if no transaction is found initially.

3. 1 hour: Third check.

4. 2 hours: Fourth check.

5. 4 hours: Fifth check.

6. 8 hours: Final check.

After 15 minutes, the address is set to timeout. If the transaction is found after the timeout, the selling price is recalculated and notified through the callback URL.

Transaction Found

 {
  "statusCode": 200,
  "merchant_id": "9cc5c-d243a-9f952-66b92",
  "hash": "0YrwsUOcXmCX8GpY4N64CgEwsYh/Gk3s2m56DoBiwM2Xp3AHthc8R14PAfhb0CtDuTENB+K1fMaA5XnvJBHLoA==",
  "data": {
    "address": "3MitLfWoRxvaA3FHZHqdDQJAQSUFGnkAcG",
    "balance": 0.00981,
    "sell_price": 9260.25,
    "usd_balance": 90.84,
    "txid": "txid1234456789876543",
    "timestamp": 1582949871
  }
}

Address Timeout

 {
  "statusCode": 10011,
  "merchant_id": "9cc5c-d243a-9f952-66b92",
  "hash": "HbUGU9q0DBMl/Lgzfy/3XkvXzEilh51GMbs3uEB0rNcguxjNfLuo1CGAsqYvdwzr90s+TAoaWdLsnjUrc5He2A==",
  "data": {
    "address": "3MitLfWoRxvaA3FHZHqdDQJAQSUFGnkAcG",
    "msg": "Address timeout",
    "timestamp": 1582949945
  }
}

Confirmation Counts

• 1 Confirmation:

   {
    "statusCode": 200,
    "merchant_id": "9cc5c-d243a-9f952-66b92",
    "hash": "dEebptMC3XYervCusINtGn9k/KJ/XTTRI9ulkGveED/G9bxaAEZ/uDCvmssCpiV81K8g+Q67fCwMi6l8+wdiJQ==",
    "data": {
      "address": "3MitLfWoRxvaA3FHZHqdDQJAQSUFGnkAcG",
      "txid": "txid1234456789876543",
      "confirmation": 1,
      "usd_balance": 95.47,
      "balance": 0.01045,
      "sell_price": 8727.2,
      "timestamp": 1582950104,
      "risk_level": 1
    }
  }

• 3 Confirmations:

   {
    "statusCode": 200,
    "merchant_id": "9cc5c-d243a-9f952-66b92",
    "hash": "uxUNsinUTxD7YRAAJiLNNfDKn7+KXUY3k/l7nPz9Tpx9Zhqc2jQzb65gTFRfT7DZp0+S7lotuiT36gr5Qw+4ow==",
    "data": {
      "address": "3MitLfWoRxvaA3FHZHqdDQJAQSUFGnkAcG",
      "txid": "txid1234456789876543",
      "confirmation": 3,
      "usd_balance": 95.47,
      "balance": 0.01045,
      "sell_price": 8727.2,
      "timestamp": 1582950200,
      "risk_level": 1
    }
  }

• 6 or More Confirmations:

   {
    "statusCode": 200,
    "merchant_id": "9cc5c-d243a-9f952-66b92",
    "hash": "uxUNsinUTxD7YRAAJiLNNfDKn7+KXUY3k/l7nPz9Tpx9Zhqc2jQzb65gTFRfT7DZp0+S7lotuiT36gr5Qw+4ow==",
    "data": {
      "address": "3MitLfWoRxvaA3FHZHqdDQJAQSUFGnkAcG",
      "txid": "txid1234456789876543",
      "confirmation": 6,
      "usd_balance": 95.47,
      "balance": 0.01045,
      "sell_price": 8727.2,
      "timestamp": 1582950200,
      "risk_level": 1
    }
  }

Response Parameters

Parameter Name	Type	Explanation
address	string	Bitcoin address involved in the transaction
txid	string	Blockchain transaction identifier
confirmation	number	Number of confirmations for the transaction
usd_balance	decimal	The equivalent balance in USD
balance	decimal	The amount of Bitcoin received
sell_price	decimal	The price of Bitcoin at the time of transaction
timestamp	number	Timestamp when the transaction occurred
risk_level	number	0, pending 1 low, 2 high, 3 medium, 4 severe