Endpoints

Deposit callback

Optionally notify Cloak after the deposit confirms so the order can be processed sooner.

POST/cloak/v1/deposit

Examples in

Orders still complete if you do not call this endpoint.

Body

Field		Description
trackingIdstring	required	From order creation.
txSignaturestring	required	The signature of the deposit transaction your user submitted.

Request

curl -sS -X POST "https://api.veilo.network/cloak/v1/deposit" \
  -H "Authorization: Bearer $VEILO_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "trackingId": "TRACKING_ID", "txSignature": "DEPOSIT_TX_SIGNATURE" }'

The signature is a hint, not proof

Cloak verifies the signature on-chain. An invalid signature cannot move funds or mark an order as paid.

Do not block on this call

If the callback fails, continue to poll status. The order will still be detected, and sending the callback more than once is safe.