Webhook events

This section provides a list of possible events that can be received as webhook callbacks.

Event	Description
identification-attempt.approved	Identification attempt has been approved
identification-attempt.rejected	Identification attempt has been rejected. See Identification attempt rejection reason for possible reject reasons.
trade.created	Trade has been created
trade.completed	Trade has been completed
trade.transfer-in-completed	Trade transfer in completed and waiting for transfer out to be sent
trade.cancelled	Trade has been cancelled
trade.expired	Trade has been expired
trade.rejected	Trade has been rejected
otc-trade.completed	OTC trade has been completed. The only event possible for OTC trades.

context of identification-attempt.approved event

JSON

{
    "traderId": "26286"
}

context of identification-attempt.rejected events

JSON

{
  "traderId": "1",
  "rejectReason": "DENIED" // Only for rejected event
}

context of trade events (trade.rejected, trade.cancelled, trade.expired)

JSON

{
  "id": "1235",
  "traderId": "123",
  "residenceCountry": "DK",
  "partnerContext": {
    "clientId": 123,
    "refId": 12
  }
}

context of trade events (trade.created, trade.transfer-in-completed, trade.completed)

JSON

{
  "id": "1235",
  "traderId": "123",
  "residenceCountry": "DK",
  "eurAmount": 100,
  "transferIn": {
    "medium": "card",
    "amount": {
      "amount": 103,
      "currency": "EUR"
    },
    "totalFee": {
      "amount": 3,
      "currency": "EUR"
    }
  },
  "transferOut": {
    "medium": "blockchain",
    "amount": {
      "amount": 0.099,
      "currency": "BTC",
      "isApproximate": false // If this is set, we cannot guarantee the amount or fee
    },
    "totalFee": {
      "amount": 0.0001,
      "currency": "BTC"
    },
    "details": {
      "address": "btc-address",
      "transaction": "btc-tx-id"
    }
  },
  "partnerContext": {
    "clientId": 123,
    "refId": 12
  }
}

context of otc-trade.completed event

JSON

{
  "id": "1234-1234",
  "time": "yyyy-mm-ddThh:mm:ss.msZ",
  "event": "otc-trade.completed",
  "context": {
    "traderId": "123",
    "residenceCountry": "DK",
    "id": "1234",
    "partnerFee": {
      "amount": {
        "amount": 100.00,
        "currency": "EUR"
      }
    },
    "totalFee": {
      "amount": {
        "amount": 200.00,
        "currency": "EUR"
      }
    },
    "transferIn": {
      "amount": {
        "amount": 30000,
        "currency": "EUR"
      },
      "details": {
        "address": "abcd",
        "transaction": "efgh"
      },
      "transactionTime": "yyyy-mm-ddThh:mm:ss.msZ"
    },
    "transferOut": {
      "amount": {
        "amount": 1.000,
        "currency": "BTC"
      },
      "details": {
        "address": "ijkl",
        "transaction": "mnop"
      },
      "transactionTime": "yyyy-mm-ddThh:mm:ss.msZ"
    },
    "createTime": "yyyy-mm-ddThh:mm:ss.msZ"
  }
}