Event Types

1. DEPOSIT

Sent when a user's deposit is confirmed on-chain and funds have been swept to the bankroll.

Delivery: Fire-and-forget. Failures are logged but do not affect deposit processing.

Payload fields:

Expected response:

{
  "error": 0,
  "description": "ok",
  "transactionId": "your-internal-id"
}

Idempotency: Use idempotencyKey to deduplicate. You may receive the same deposit event more than once.

2. WITHDRAW_REQUEST

Sent before a withdrawal is processed, requesting your approval. The withdrawal will only proceed if you return error: 0.

Delivery: Synchronous. The system waits for your response before continuing.

Payload fields:

To approve - return:

{
  "error": 0,
  "description": "ok"
}

To deny - return a non-zero error code:

{
  "error": 5,
  "description": "Daily withdrawal limit exceeded"
}

Error codes:

Any other non-zero code will show the description field from your response as the error message.

3. WITHDRAW_COMPLETE

Sent after a withdrawal has been completed (status changed to COMPLETED by an admin).

Delivery: Fire-and-forget. Failures are logged but do not affect the withdrawal status.

Payload fields:

Expected response:

{
  "error": 0,
  "description": "ok"
}