Callback Payload

After an operation changes status, the system sends an HTTP callback (webhook) to the callbackUrl you specified when creating the deposit or withdrawal.

Delivery

Method: POST

Content-Type: application/json

Timeout: 20 seconds per attempt

Retries: up to 3 attempts with exponential backoff (1s, 2s, 4s)

Your endpoint must respond with any 2xx status code to confirm receipt. Any other response or timeout triggers a retry.

{
  "operationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "operationType": "deposit",
  "status": 1,
  "amount": "100.00",
  "receivedAmount": "95.00",
  "currency": "USDT",
  "paymentMethod": "card",
  "merchantOperationId": "order-001",
  "createdAt": "2026-05-28T12:00:00.000Z",
  "confirmedAt": "2026-05-28T12:05:00.000Z",
  "signature": "a3f2b8c1d4e5..."
}

Fields

Field	Type	Always present	Description
`operationId`	string (UUID)	Yes	Unique operation identifier
`operationType`	string	Yes	`"deposit"` or `"withdrawal"`
`status`	number	Yes	Operation status (see Statuses)
`amount`	string	Yes	Initial operation amount
`receivedAmount`	string	No	Net amount received by merchant after fee. Only for deposits with final status (`Approved`, `Declined`)
`subtractedAmount`	string	No	Total amount debited including fee. Only for withdrawals with final status (`Approved`, `Declined`)
`currency`	string	Yes	Currency code (e.g. `USDT`, `USDC`)
`paymentMethod`	string	Yes	Payment method used (e.g. `card`)
`merchantOperationId`	string \| null	Yes	Your operation identifier passed during creation, `null` if not provided
`createdAt`	string (ISO8601)	Yes	Operation creation timestamp
`confirmedAt`	string (ISO8601) \| null	Yes	Timestamp when operation reached final status, `null` if still processing
`signature`	string	Yes	HMAC-SHA256 signature for verification (hex)

Amount Fields Logic

For deposits with a final status:

receivedAmount = amount - merchant fee (net amount credited to balance)

For withdrawals with a final status:

subtractedAmount = amount + merchant fee (total amount debited from balance)

These fields are only present when the operation has reached a final status (Approved or Declined).

Statuses

Code	Status	Description
1	`Approved`	Operation completed successfully
2	`Declined`	Operation was declined
3	`Processing`	Operation is still being processed

Status codes are the same for both deposits and withdrawals.

Callback Payload

Delivery#